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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M/M-PLUS Command Language Manual provides information needed 
to use a terminal to do work on an RSX-11M/M-—PLUS system. Important 
system concepts are introduced and explained in the context of the 
DIGITAL Command Language (DCL). DCL is a user-oriented command 
language with English words and prompting for required command 
elements. 


INTENDED AUDIENCE 


This manual is intended for any user of an RSX-11M/M-PLUS system. The 
manual is aereference manual with many tutorial elements, but new 
users should read the Introduction to RSX-11M and RSX-11M-PLUS first. 


A user is anyone who interfaces with the system to perform some task. 


There are two kinds of wuSers: privileged and nonprivileged. 
Privileged users have access to functions that control and modify 
system operation as well as functions that permit program development 
and system maintenance. Nonprivileged users have access to functions 
required for program development and local maintenance only. 


STRUCTURE OF THE DOCUMENT 


The manual is organized around the major operating system functions. 
Following the introduction, each major function has a chapter to 
itself. All commands relating to the function are described in the 
chapter. The last chapter is an annotated alphabetical listing of all 
DCL commands. 


Chapter 1 introduces the basic concepts of DCL and explains how DCL is 
implemented on RSX-l1M/M-PLUS, as well as including many hints on 
using DCL. The chapter includes summaries of the remainder of the 
manual, and other introductory and summary material about DCL, the 
operating system, and various utilities and system tasks. 


Chapter 2 lists the most common forms of SET and SHOW commands. 
Chapter 3 covers terminal operations, including logging in and logging 
out, keyboard terminology and functions, setting and displaying 


terminal attributes, broadcasting messages, and using the system HELP 
commands. 
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Chapter 4 introduces file-handling operations on RSX-11M/M-PLUS, 
including commands to create and delete files, list directories, and 
rename, copy, type, and print files. Wildcards and defaults are 
explained. 


Chapter 5 covers peripheral devices and introduces the system I/0 
terminology. The chapter explains the relations between hardware 
devices and the software file system, and describes how to prepare 
scratch disks and magnetic tapes for use on the system. Commands 
affecting devices and software volumes are described. 


Chapter 6 introduces the program-development facilities of the system 
and the DCL commands used with these facilities. 


Chapter 7 explains how tasks run in the system, how they are named, 
installed, fixed in memory, and controlled while’ running. In 
addition, commands to abort tasks, to place tasks in the clock queue, 
and to display information about tasks in the system are described. 


Chapter 8 covers the DCL system-control commands. 


Chapter 9 is the alphabetical listing of all DCL commands and _ their 
formats, including comments to remind you of specific points about 
Many commands and command elements. Each entry in Chapter 9 includes 
a cross-reference to the full command description in an earlier 
chapter. Chapter 9 is marked by a blue tab for quick reference. 


Appendix A explains error messages common to several DCL commands. 
Other command-specific error messages are explained in the full 
command descriptions. 


Appendix B lists the relations between DCL and the rest of the 
operating system. 


Appendix C is a Summary of Technical Changes. This appendix lists all 
the command syntax that has changed or been added to DCL since 
RSX-11M-PLUS V1.0. These changes are extensive. 


ASSOCIATED DOCUMENTS 


Other documents related to RSX-11M/M-PLUS are described in the 
RSX-11M/RSX-11S Information Directory and Index. 


Other documents related to RSX-11M/M-PLUS are described in the 
RSX-11M-PLUS Information Directory and Index. 


If you are entirely new to computers or to DCL, you should read _ the 
Introduction to RSX-11M and RSX-11M-PLUS and follow through as 
instructed there. 


Although this manual is meant to be self-contained, you will find 
important information in the RSX-11M/M-PLUS MCR Operations Manual and 
the RSX-11M/M-PLUS Utilities Manual. 


Programmers should see the RSX-11M/M-PLUS Guide to Program 
Development. 
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CONVENTIONS USED IN THIS DOCUMENT 


A number of conventions are used in the command descriptions in this 


manual: 


Convention 


{[/qualifier] 


{g,m] 


UPPERCASE 


lowercase 


/qualifier 


parameter 


sargument 


Meaning 


The vertical ellipsis denotes elements of command 
input without relevance’ to the point being 
discussed. 


Any command field enclosed in brackets is 
optional. If the brackets include syntactical 
elements, such as dots (.) or Slashes (/), those 
elements are required for the field. If the field 
appears in lowercase, you are to substitute a 
legal command element if you include the field. 


This signifies either a User Identification Code 
(UIC) or a User File Directory (UFD). The g is a 
group number and the m is a member number. Where 
a UIC or UFD is required, only one set of brackets 
is shown, as [g,m]. Where the UIC or UFD is 
optional, two sets of brackets are shown, as 
{{g,m]]. The UIC identifies a user. The UFD 
identifies a directory. 


Any comand field in uppercase indicates that you 
should type the word or letter exactly as shown. 


Any command field in lowercase is to be 
substituted for. Usually the lowercase word 
identifies the kind of substitution expected. 


Any command element preceded by a slash (/) is a 
DCL qualifier. Command qualifiers alter the 
action of a command they are attached to. 
Parameter qualifiers modify the action of the 
command as it affects that parameter. 


Required command fields are generally called 
parameters. The most common parameters are file 
specifications. Parameters are preceded by blanks 
or DCL prompts. 


Some parameters and qualifiers can be altered by 
the inclusion of arguments preceded by a colon. 
Arguments can be either numerical or alphabetical. 
The equal sign (=) can be substituted for the 
colon to introduce arguments. 
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Convention 


filespec 


red ink 


RET 


pink shading 


gray shading 


PREFACE 


Meaning 


A full file specification includes device, UFD, 
file name, file type, and version number, as in 
this example: 


DB1:[(303,5]HIPPITY.HOP; 2 


Full filespecs are rarely needed. If you do not 
give a version number, the highest numbered 
version will be used. If you do not give a_ UFD, 
the default UFD will be used. Some system 
functions default to particular file types. See 
Chapter 4 for more information on file 
specifications. See also the individual command 
descriptions. 


Some commands accept a filespec with a DECnet node 
name. See Chapter 1 for more information. 


All user input in examples is printed in red ink. 


An oval symbol with a 2- to 6-character 
abbreviation indicates that you are to press the 
corresponding key on your terminal. For example, 
RET indicates that you are to press the RETURN 
key, and DEL means that you are to press’ the 
DELETE key. 


The oval symbol CTRL/a means that you are to press 
the key marked CTRL while simultaneously pressing 
another key. Thus, CTRL/Z indicates that you are 
to press the CTRL key and the Z key 
simultaneously. This is echoed on your terminal 


as “Z. Not all CTRL characters echo. See Chapter 
3 for more information. 


Text shaded in pink describes the RSX-1L1M 


Operating System only. 


Text shaded in gray describes. the RSX-11M-PLUS 
Operating System only. — 


See Chapter 1 for more information on DCL conventions. 
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CHAPTER 1 


INTRODUCTION 


DCL is the DIGITAL Command Language. DCL provides RSX-11M/M-PLUS 
users with an extensive set of commands’ for interactive program 
development, device and file manipulation, and interactive program 
execution and control. 


If you are new to computers, or if you wish a quick review of DCL and 
the operating system, you should read the Introduction to RSX-11M and 
RSX-11M-PLUS. This manual includes a guided tour of the operating 
system, including an interactive terminal session that introduces all 
of the most commonly used DCL commands. 


DCL commands are full words that describe the action to be taken, not 
abbreviations or mnemonics. Thus, if you wish to set a terminal to 
lowercase, you type SET TERMINAL/LOWERCASE. Because DCL commands and 
command elements are full words, they are self-documenting. 


You are not required to use the full form of DCL commands at _ the 
terminal, however. Usually, you need type only the command elements 
required to form a unique command. For instance, SE TE/LOW will also 
set a terminal to lowercase, but SE TE/LO will not work because there 
is also a command SET TERMINAL/LOCAL. See Section 1.2 for more 
information on how DCL commands are parsed. 


1.1 RSX-11M/M-PLUS AND DCL: BASIC CONCEPTS 


RSX-11M/M-PLUS systems may have one or more command line interpreters 
(CLIs). All systems include MCR (the Monitor Console Routine). Many 


systems also include DCL, and some systems include other CLIs. Both 
MCR and DCL include commands to invoke most system tasks and utilities 
and to set and display certain system characteristics. In general, 


MCR commands name tasks, such as PIP, a utility used to manipulate 
files (for example, to copy or type them), while DCL commands’ specify 
actions directly, as in the COPY command or the TYPE command. 


MCR is the fundamental command line interpreter (CLI) for the 
RSX-LIM/M-PLUS Operating Systems. MCR also provides commands to set 
and display certain system characteristics. MCR provides the most 
direct interface with the operating system, either RSX-11M or 
RSX-11M-PLUS. 


In general, MCR commands must be entered in exact syntax. MCR 
commands follow no set syntax rules, however. Most MCR commands are 
terse abbreviations or mnemonics. 


DCL is an optional user-oriented CLI included in most systems with 
many users. Commands in DCL are English-like words and follow 
well-defined syntax rules. Full commands are self-documenting. DCL 
is designed for consistency and ease of use. 
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DCL is based on the command languages used on a number of DIGITAL 
operating systems. In particular, RSX-11M/M-PLUS DCL is designed for 
compatibility with future releases of VAX/VMS DCL. See Section 1.7 
for more information on DCL compatibility. 


DCL on RSX-11M and RSX-11M-PLUS systems is a CLI task that translates 
DCL commands into MCR commands for execution by the system. The DCL 
SET DEBUG command displays the MCR translation for any DCL command on 
your terminal. See Section 1.2.15 for more information on the SET 
DEBUG command. 


Depending on the kind of use you make of your system and the nature of 
your system, you may find it more convenient to use one CLI or the 
other, or both. All nonprivileged system functions are available 
directly from DCL, but some privileged functions are not. All 
program-development facilities and all common utility functions are 
available from DCL. 


Because RSX-11M and RSX-11IM-PLUS are designed to be tailored to _ the 
needs of each installation, not every feature of DCL described in this 
manual is available on every system. Some DCL commands depend on 
layered products that may not be available at your installation. Many 
features, particularly on RSX-1LIM systems, are system-generation 
options that may not have been selected at the time your system was 
generated. Shaded text indicates that the feature is available on 
only one system. You should see your system manager or another 
knowledgeable system user if some feature described in this manual 
does not appear to be available at your installation. 


1.2 THE DCL COMMAND LINE 


A command consists of a command name or verb describing the a 
system is to take. Most commands also include one or more 

and qualifiers to further define the action of the command. 
Qualifiers are preceded by a slash (/) and parameters are preceded by 
a space. Both qualifiers and parameters’ can take arguments. 


Arguments are preceded by a colon (:). 


Commands are passed to the operating system with a terminator, either 
RETURN or _ ESC. (The ESC key may be labeled SEL or ALT MODE. Its 
action differs from that of the RETURN key in that the cursor does not 
return to the left margin and no monitor prompt is returned after 
execution is completed.) . 


Unless the action of the RETURN differs greatly from what is expected, 
the examples and command formats in this manual do not include an 
indication that each line in the command is terminated by a carriage 
return. (See Section 1.2.13, for a discussion of command lines too 
long to fit on one line of your terminal.) 


Some commands require parameters or arguments as part of the command 
line. If you fail to supply a required command element, DCL prompts 
you with one or two words indicating the general nature of the 
required element. If you do not understand the prompt, type a 
question mark (?) for help. (In some cases, an omission causes an 
error rather than a prompt.) 


Section 1.2.1 discusses prompting in detail. 


This section introduces the rules governing the use of DCL. The 
examples in this section are intended to illustrate these rules, not 
to illustrate the full capabilities of the command. For more detail, 
see the individual command descriptions. 
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1.2.1 Prompting 


The prompts teach you the form of a command by requesting that you 
supply required command elements. 


For example, the RENAME command works as follows: 
>RENAME 
From? BROWNS.STL 
To? ORIOLES.BLT 

The one-line format for RENAME is: 


“RENAME BROWNS.STL ORIOLES. BLT 


The formats can be mixed. DCL prompts for whatever you leave out. 
For example: 


“RENAME BROWNS.STL 
To? ORIOLES.BLT 


There are no defaults for prompts. You must supply a response to any 
prompt. If you do not wish to continue with the command, type a 
CTRL/Z« 


1.2.2 Qualifiers 


Qualifiers modify the action of the command. Qualifiers always start 
with a slash (/) and are generally optional. 


Qualifiers are either command qualifiers or parameter qualifiers. 
Most qualifiers are command qualifiers. In this manual, command 
qualifiers are always shown as modifying the command verb, as in this 
example: 

STYPE/TODAY *.HLF 
However, most command qualifiers can appear anywhere in the command 


line, Another name for these qualifiers is floating qualifiers. The 
following examples illustrate how command qualifiers can float: 


>TYPE &,HLE/TOLAY 
or 


eB a a 
File(s)? #*,HLP/TOLAY 


or 
ALY PE 
Filedsi? /sTODAY 
File(s)? ¥,.HLF 


You can mix formats, as in the following example: 


=TYPE/TOLAY 
File¢si)? & HLP/EXCLUDESHELFF.HLES# 


or 
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*TYPE/TODAY 
File(s)? ¥+HLF/ 
Qualifier? EXCLUDE SHELFF.HLFs* 


or 


°TYFE/TODAY 

File(si? / 

Quelifier? EXCLUDE!HELFF.HLF3s?: 
File(s)? HLF 


Note that you are prompted for a qualifier when a slash with no 
qualifier attached appears on tk: command line. When you supply the 
qualifier, do not type the slash | ,ain. 


Regardless of where the qualifier appears, it has the same effect. 


Almost all command qualifiers can float in this way. Ina few cases, 
the command qualifier must appear directly after the command it 
modifies. Whenever two similar commands are described separately, 
such as ASSIGN and ASSIGN/REDIRECT or CREATE and CREATE/DIRECTORY, the 
distinguishing qualifier cannot float. Other qualifiers to such 
commands can still float, however, as in this example: 


PCREATE/DIRECTORY 
Devices UFI?T £C303/S517/ALLOCATION:S 


which is the same as 
"CREATE/DIRECTORY/ALLOCATION!:5S (C303;5] 


Qualifiers described as parameter qualifiers, or filespec qualifiers, 
cannot fioat. Most DCL parameters are fiiespecs. 


Parameter qualifiers do not modify the action of the command; they 
modify the action of the command as_ it concerns that particular 
Parameter or supply additional information needed for the command to 
execute properly. For instance, in the following example: 


sHACRO HIYA, TESTBLI/SLIBRARY: FIGEON 


the qualifier /LIBRARY identifies a particular file as being a 
library. Obviously, /LIBRARY could not float. 


If, however, a command has parameter qualifiers that are identical to 
command qualifiers, you may find confusing results from floating 
qualifiers. 


For instance, the PRINT command has both the command qualifier /COPIES 
and the parameter qualifier /COPIES. For instance, if you attach the 
/COPIES qualifier to the PRINT command, as shown below: 
UsPRINT/COPLES!2 OZY.TXT 
then two copies of the file are queued for printing. 
You can include more than one file in a PRINT command. Each file 
specified is a parameter to the PRINT command, although only the first 
file is a required parameter. The command 
SPRINT OZY.TXT, [22Z2Y.TXT/COPIES(2 
includes the parameter qualifier /COPIES:2. The command causes. one 


copy of OZY.TXT to be printed, which is the default, and two copies of 
IZZY.TXT to be printed because the default was overridden. 
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Many qualifiers can be negated by prefixing NO or - (minus) to the 
qualifier name. Thus, the command 


*MACRO/OBJECT SIMFPLE.MAC 


directs the MACRO-11 Assembler to make an object file, while the 
command 


=MACRO/NOOBJECT SIMFLE.MAC 
or 


*MACRO/-OQRJECT SIMPLE.MAC 
directs the MACRO-1l Assembler to on 2t the object file. In the first 
example, /OBJECT is the default qualifier and need not be explicitly 
included. In other words, unless your MACRO command includes’ the 
/NOOBJECT qualifier, an object file is produced. 


1.2.3 HELP 


HELP is available from the system for all DCL commands and also _ for 
many other aspects of the system. You can get help through the HELP 
command or by typing a question mark (?) in response to any DCL 
prompt. 


For instance, if you wish help on the TYPE command, type the 
following: 


SHELF TYRE 
TYFELZanuelifier(lsi11 filesrecEs] 

/DATEG dd-mmm—-yey 
/SINCEidad-mam-vey 
/THROUGHidd-mmm-yvy 
/SINCE?} dd-mmm-ge/ THROUGH dd-mam-ey 
“TODAY 
/EXCLUDE? fileseec 


The TYFE command diselavas the comtents of text files on wour 
terminel. ; 


The HELP text consists of a brief explanation of the command followed 
by an illustration of the syntax, showing that TYPE accepts one or 
more filespecs, and one or more qualifiers. See Section 4.4.1 for 
more information on TYPE and its qualifiers. Or, type a HELP command 
naming the qualifier to get more information on that qualifier. 


“HELP TYPE TODAY 
TYPE/TODAY filesrec(s] 


Tne /TODAY auelifier srecifies thet you wish the TYFE command to 
tyre only files crested today. 
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If you wish help while being prompted by the TYPE command, use _ the 
following procedure: 


> TYPE 

File(s)? * 

TYFEC/aquelifierf€s]] filesrecEs] 
/TATE $dd-mmm-yey 
/SINCEt dd-mum-gvy 
/THROUGH i dd-mmm-yy 
/SINCEt{ dd-mmm—-yy/ THROUGH dd-mmm-yy 
/TOUAY 
/EXCLUDE?: filesrec 


The TYFE command disrlays the contents of text files on your 
Lerminal. 
pe 


latsi? 
SE057! 


The same help text is printed on your terminal, but the prompt 
returns, meaning the TYPE command is still waiting for you to list the 
files you wish typed. 


You can also get help on a specific subtopic while being prompted by a 
command by responding to the prompt with a question mark. For 
example: 


SSET 
“sncbion? ? 
SET thins 


“TT 


The SET command can be used to set somethina, The following 
things can be set with this command: 


COAYITIME DEBUG DEFAULT DEVICE GROUPFLAGS 
LIBRARY CNOIFARTITION FRIORITY FROTECTION QUEUE 
SYSTEM TERMINAL 


For informetion on the SET ACCOUNTING command; see HELF 
SCCOUNTING SET. 


To get help on a specific thing, enter a question mark followed by the 
ching: 


Function? ? DEFAULT 
SET DEFAULT Cddnnt It Cufdal] 


Tne SET DEFAULT commend sets your default directory or devices 
or bathe 


SET DEFAULT with mo rarameters returns 2g nonrerivilesed user to 
tne losin device and UFI. For erivilesed users: the unsdorned 
SET DEFAULT returns to the login devicer but the UFD remains the 
Same. 


Funmetion? 7 


You can also get help by typing a question mark in response to the 
system prompt (>) and to the explicit DCL prompt (DCL>). 


If you should decide after reading the help text that you have chosen 
the wrong command, enter a CTRL/Z in response to the prompt to end the 
execution of the command. (A CTRL/Z in response to a prompt always 
cancels execution of a DCL command.) 
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From a DCL terminal, the command HELP provides information on DCL and 
the command HELP/MCR provides information on MCR. The command HELP 
SHOW provides information on the DCL SHOW command, and HELP SHOW 
TERMINAL provides information on the DCL SHOW TERMINAL command. 


From an MCR terminal, the command HELP provides information on MCR and 
the command HELP/DCL provides information on DCL. 


There may also be special help files providing information on special 
aspects of your installation. In addition, you can create local help 
files for your own use. 


See Section 3.5 for more information on the HELP command and help 
files. 


1.2.4 MCR and DCL Commands 


You can usually enter MCR commands from terminals set to DCL or DCL 
commands from terminals set to MCR. 


If you are at a DCL terminal and wish to enter an MCR command, simply 
precede the command with an MCR. The command is passed directly to 
MCR while the terminal remains set to DCL. 


Here is the format of the MCR command: 


DCL>MCR 
MCR command line? mcrcommand 


or 
DCL>MCR mcrcommand 

And, if you wish to enter a DCL command from an MCR terminal, use the 

DCL command. The command is executed and the terminal remains set to 

MCR. Here is the format of the DCL command: 


MCR>DCL dclcommand 


There are no prompts from this command. 


1.2.5 Abbreviations 

It is rarely necessary for you to type either the complete command 
name or the complete qualifier name. You only need to type the 
characters needed to distinguish the command or qualifier from all 
others. 

For example: 


e TYPE can be abbreviated T because it is the only command 
beginning with that character. 


@e INITIALIZE can be abbreviated INI, but not IN. 
e INSTALL can be abbreviated INS, but not IN. 
Three letters will usually be enough. Four letters will always’ be 


enough. You can often omit other parts of commands as well. You 
should experiment to find how short various commands can be cut. 
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For instance, the command 
“SET TERMINAL/YTS2 


is the documented format for the command that sets a terminal as a 
VT5S2. The same command to VAX/VMS DCL does the same thing. However, 
the RSX-11M/M-PLUS version of DCL permits you to type the following 


'SE YTS 
to achieve the same result. 


These briefer forms should be used interactively only, and not’ used 
when you are making a permanent record or creating an indirect command 
file (or batch job). You should also see Section 1.6.1 for a 
discussion of compatibility between RSX-11IM/M-PLUS DCL and other 
versions of DCL used on other operat 


wot 


. 
na sys tam 


4 a 
a hty WLLL e 


For your convenience, some frequently used commands have brief forms. 
These are: 


Command Brief Form Command Brief Form 
ABORT A HELP H 
BROADCAST B HELP ? 

COPY Cc LOGOUT LO 
DIRECTORY D LINK L 
DEALLOCATE DEA MACRO M 
DEASSIGN DEAS PRINT P 
EDIT EB RUN R 
FORTRAN F SHOW S 


These shortened forms replace the command verbs for entering commands. 


See the Note in Section 1.6.1 on support for brief command formats. 


1.2.6 Numbers and Dates 
DCL recognizes both octal and decimal numbers. You usually do not 
have to identify a number as octal or decimal. All numbers are 
recognized as being octal or decimal, unless otherwise noted. 
DCL recognizes dates in two forms: 
dd-mmm-yy as in 21-JAN-82 
or 


mm/dd/yy as in 1/21/82 


System displays are always in the first format. 


1.2.7 Multiple Parameters 

Some commands permit you to enter a single filespec or other parameter 
by a list of parameters. If you are entering a list of parameters, 
@acn parameter must be set off by commas. For example: 


SPRINT ALPHG. TAT 
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causes a single file to be printed, while 
PRIM T ALPHA, TXT+ BETA.THT: GAMMA. TRT 


causes three files to be printed. You have the option of including 
blanks on either side of the comma in lists. 


If you end the list with a comma, DCL prompts you for further 
parameters. For instance, 


SPRINT ALPHA.TAT: BETA. TXT? 

File(s)? GAMMA. TET 
Some commands accept a list of arguments to a single qualifier or 
parameter. In such cases, the list of arguments must be enclosed in 
parentheses, with each element set off by commas. For example: 


sMACKO/SHOW? CCALLS*»+COMMENTS?) HIYA 


If you need to enter only a single argument, you do not need the 
parentheses. For example: 


SMACRG/SHOWI CALLS HIYA 


1.2.8 Underscore Character 
The underscore character (_) is used to make DCL commands more 
readable where two words are needed to name a single command element, 


such as PRINT/FLAG PAGE. However, you need not type the underscore to 
enter the command. PRINT/FLAGPAGE is the same as PRINT/FLAG PAGE. 


1.2.9 Colon and Equal Sign 


The command descriptions in this manual show arguments set off by a 
colon (:), such as 


WPRINT/COPIES? 2 TZ2ZY¥4 TAT 


You can always replace such colons with an equal sign (=), as in this 
example: 


<FRINTSCOPIESS2 2220 0TAT 


Colons in device names, such as DBl:, and so forth, cannot be replaced 
by equal signs. 


1.2.10 Quoting Strings 


If you wish to include an exact string in a DCL command, put the 
string in quotes. For instance, the message 


SRROADCAST/ALL Rock and roll will never die 
is broadcast as 


Li-BEC-82 13:55 From PRINCE: ;WRITERS (TT443) to ALL 
ROCK AND ROLL WILL NEVER DIE 
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while 
> RROAUCAST/ALL "Rock and rojJl will never die*® 
is broadcast as 


L1-fTEC-82 1357354 From FRINCE:i:WRITERS (TT64i) to ALL 
"Fock smd roll will never die? 


You also need quotes when passing commands to tasks using the 
/PARAMETERS qualifier to MOUNT or the /COMMAND qualifier to RUN or 
INSTALL. 


1.2.11 ANSI File Names 


ANSI file names do not have the same format as Files-1l file names and 
May contain characters that are illegal in Files-1ll. For instance, 
"“"MONEYS."" is a legal ANSI file name, as is ""CASHS."". To use those 
file names in a command, simply enter them as shown in the following 
example: 


eur y 
From? MMi" "MONEYS," " 
To? MMI ""CASHS."* 


If you are copying a file from a tape to a Files-1ll disk, however, you 
must use only Radix-50 file specifications, such as 


ZEGPY 
From? MMi" "MONEY¢, "* 
Tot DRICS6Gs1IRANTXSG. TXT 


The Radix-50 character set consists of the numbers 0 through 9, the 
letters of the alphabet, the dollar sign (S$) and the period (.). 


1.2.12 DECnet and DCL 


Some commands will accept DECnet node names as part of a filespec. 
They are: 


APPEND DELETE 
COPY DIRECTORY 
CREATE TYPE 


If the node you name has a DECnet default account, you can simply add 
the node name to the filespec in the following fashion: 


TYPE FRINCES $0OB23;0303»57RQMAN, TXT 


All the usual rules about file and volume protection are maintained, 
of course. 


If the node you name has named directories, you must enclose the 
filespec in quotes, as shown: 


eTYPE EEETEES ? "DISKS$USERDISK? COALTONIDESFERATO.OIS" 
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1:2.13 Command Line Continuation 


The hyphen (-) is used to indicate line continuation. When you end a 
command line with a hyphen and a carriage return, the DCL continuation 
prompt (->) indicates that you can continue entering the command line. 
If you are continuing a line from a prompt, such as Task? that prompt 
is the indication that the line is being continued. 


This feature permits you to enter command lines including more 
characters than your terminal has room for on one line. 


Most DCL commands are limited to 250 characters in all. No command 
line can be longer than 250 characters. 


Here is an example of line continuation: 


sPRINT/COPIES? 2/LENGTH! 60/FLAGFAGE/AFTER? (04-JUL-80) OZY.TXT»~ G&D 
~xIZZY¥.TXTy FIZZY«TXT GED 


The command is not entered until DCL encounters a line ending with a 
carriage return not preceded by a hyphen. In the example, the first 
carriage return does not enter the command. Only the second carriage 
return enters the command. The carriage return can be on a line by 
itself. 


-RSX-11M-— 

for both MC 

RSX=11M. sup 

DCL only.’ 

a DCL comma 

an». MCR “long: for: the 
system t -cases,,..you 
should ex and to find 
unnecessary as defaults 
that - need ecified 6r 
qualifier: “be entered’ 
separately eating your: 
purpose. st it en os 


1.2.14 Comments in Command Lines 


You can include comments in a DCL command line with the exclamation 
point (1). 


If the comment ends the command line, only a single exclamation point 
is needed, as in this example: 


SPRINT OZY.TXT 'Foem ov Snelley 


If the comment is within the command line, two exclamation points are 
needed, as in this example 


SPRINTIFarody of Shelley! I2ZY.TXT 
These comments are ignored and not interpreted in any way by DCL. 
Comments can be placed at any natural break in the command line: 
t 


between qualifiers, between parameters, even as part of a response 
a prompt. 
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Another example: 
SPRINT/FORMSi{2!Letter-aueslity Frinter! IZZY.TXT 


You may want to include comments when you are keeping a permanent 
record of a terminal session. 


1.2.15 SET DEBUG 
SET DEBUG displays the MCR translation of any DCL command. 
Format 

SET [NO] DEBUG[/qualifier[s]] 

Command Qualifiers 


/ [NO] EXECUTE 
/FULL 


Command Qualifiers 
/ [NO] EXECUTE 


The /EXECUTE qualifier indicates that you wish the DCL command to 
execute after the translation is displayed. The default is 
/NOEXECUTE, meaning that the translation only is displayed. When 
SET DEBUG/NOEXECUTE is in effect, you can only issue SET DEBUG 
commands or MCR commands using the DCL MCR’ command; all other 
DCL commands are trapped and translated. You can issue SET 
NODEBUG to turn off SET DEBUG. You can also issue SET DEBUG with 
either /FULL or /EXECUTE or both. 


/FULL 


The /FULL qualifier indicates that you wish SET DEBUG to display 
the logical symbols (IFORM queue) used by DCL to translate the 
command as_ well as the translation itself. See the 
RSX-11M/M-PLUS System Management Guide for information on how DCL 
uses these logical symbols. 


Examples 


SET DEEUG 

>SHOW TIME 

TUM 

= TMITIALIZE/EXTENSION:S 200/FROTECTION! (SYSiRWED OWN? RWED,GROrWO) 
Ttevice? DK2 

Label? HOTROD 

INI DRE? HOTROD/EXT=206.,/FRO=CRWED s+ RWEDs » J 
*SET DEBUG/EXECUTE 

7S TIM 

TIM 

21:33:46 11-TEC-82 

»SET NODEBUG 


In this example, the user first issued SET DEBUG. Then the user 
typed SHOW TIME. DCL displayed TIM, which is the MCR command to 
display the date and time, but no date and time is displayed 
because /NOEXECUTE was in effect. Then the user typed an 


INITIALIZE command and DCL displayed the MCR translation of the 
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Same command. Then the user typed SET DEBUG/EXECUTE and typed 
SHOW TIME again. This time, after displaying the MCR command 
TIM, DCL passed the command TIM to MCR and the date and time were 
displayed. Finally, the user typed SET NODEBUG to end session 
with SET DEBUG. 


Notes 


Use SET DEBUG to check on the MCR syntax of any DCL command. 
This is particularly helpful when learning the brief forms of 
commands. 


SET DEBUG creates your own copy of DCL that remains present while 
SET DEBUG is in effect. Therefore, SET DEBUG creates a load on 
the system. You should use SET DEBUG sparingly, particularly 
when the system is under heavy use. 


1.2.16 Errors 


You can correct typing errors or change the line completely, by using 
the RUBOUT or DELETE key, or CTRL/U (provided you have not terminated 
the line). 


You can cancel the execution of any DCL command by typing a CTRL/Z. 


If the system detects an error in the command line input, it returns 
the appropriate error message at the issuing terminal. 


Here are some examples of incorrect commands and the error messages 
they produce: 


SPRT ET IZ27.7XT 
BOL oo-- Tllesel command 


TPRINT/FURFLE ITZZY¥.TXT 
FRINT -- ITllegel or contradictory euslifier 
FRINT/FURPLE IZZY.TXT 


SFRIANT/SCORPTES!S TWELVE IZZY.TXT 
FRINT -- Numeral exrected 
PRINT/COPIESS TWELVE IZZY.TXT 


In the first case, the error was detected by DCL, as indicated by the 
first part of the error message. There is no DCL PRIJT command. The 
entire command was rejected. 


In the second case, the command was entered correctly, but the 
qualifier was incorrect. The first part of the message shows that the 
error was detected within the PRINT command itself. The command is 
reprinted and a circumflex (*) points to the error. 


In the third case, the command and qualifier were correct, but the 
argument was in error. The message explains the error and the 
circumflex points to the error. 


Sometimes the circumflex does not point directly at the error, but at 
the point at which the command started to go wrong, which may be 
several characters before the actual error. 
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Typing mistakes are by far the most common cause of errors. Retyping 
the command often eliminates the error. Other common causes of errors 
are omitting a space or other delimiter in a command line, specifying 
invalid devices or nonexistent files, issuing privileged commands from 
a nonprivileged terminal, and failing to type a sufficient number of 
characters to distinguish the command or command element. 


The command descriptions include the most common errors produced by 
the commands and suggestions for correcting the errors. All the DCL 
error messages are listed and explained in Appendix A of this manual. 
In some cases, such as file-system errors, you may need to go to 
another manual for explanation of the error or seek help from a 
knowledgeable system user. 


1.3 FUNCTIONAL GROUPING OF DCL COMMANDS 


This manual includes seven functional groupings of commands, each 
grouping constituting a chapter. Each of these chapters is described 
here. Fully detailed descriptions of each command are included in 
these functional chapters. The functional groupings of commands are 
described in Sections 1.3.1 through 1.3.7. Each functional chapter 
also includes an introduction to the important concepts of the 
functional group. 


Command descriptions can have five parts: 
e Brief statement of the function of the command. 


@e Full description of the format of the command, including 
prompts, defaults, acceptable values for arguments, and the 
effects of each qualifier. 


e Examples of the command in use. These examples often 
illustrate less obvious aspects of the use of the command. 


e Notes, including warnings about side effects, counteracting 
commands, recommendations for further reading, and so forth. 


@e Error messages, including an explanation and a suggested user 
action for each error. 


All command descriptions start with the function and the format. Most 
include at least one example. In some cases, there are no notes. 
Only error messages specific to the command are included in the 
command descriptions. General error messages, such as those relating 
to syntax, are described in Appendix A. 


The full command description includes all these parts. In particular, 
you should read the examples carefully. Often the examples clarify 
points made in the format descriptions. 


In addition, the format of each DCL command is presented in the 
alphabetical listing in Chapter 9 of this manual. 


DCL commands cover the full range of nonprivileged commands. 
Nonprivileged commands are those commands needed in everyday use of 
the system by all users. Many privileged commands are also included 
in DCL. Privileged commands are those commands that affect system 
operations. For instance, the SHOW TIME command is a nonprivilieged 
command, but the SET TIME command is privileged. 
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1.3.1 The SET and SHOW Commands 


The SET commands dynamically alter system characteristics. The SHOW 
commands display system characteristics. These commands are 
introduced in Chapter 2. The most useful functions of SET and SHOW 
are also described in Chapter 2. However, because such a wide variety 
of functions can be altered or displayed, the remaining functions of 
SET and SHOW are listed in Chapter 2 but described in the appropriate 
functional chapter. SET and SHOW are the last commands described in 
each chapter. For example, SET DEVICES and SHOW DEVICES are described 
in full at the end of Chapter 5, “Handling Devices and Volumes"; and 
SET TERMINAL and SHOW TERMINAL are described at the end of Chapter 3, 
"Terminal Operations." 


The SET or SHOW command and its function are considered to form a 
Single command. That is, rather than referring to the TERMINAL 
function of the SHOW command, you would refer to the SHOW TERMINAL 
command. 


1.3.2 Terminal Operations 


All commands directly related to terminal operations are described in 
Chapter 3. The commands include LOGIN, LOGOUT, BROADCAST, REQUEST, 
HELP, SET TERMINAL, and SHOW TERMINAL. In addition, Chapter 3 
includes a detailed description of the use of the terminal keyboard on 
RSX-11M/M-PLUS systems. All control (CTRL) characters and other 
important keys are explained. 


1.3.3 Handling Files 


Most information in RSX-11M/M-PLUS systems is in files in User File 
Directories (UFDs). These files and directories are located within 
Files-11 volumes. 


All commands relating to files are described in Chapter 4. 


The commands include CREATE, CREATE/DIRECTORY, EDIT, EDIT/EDT, 
EDIT/SLP, EDIT/KED, COPY, CONVERT, TYPE, PRINT, RENAME, DIRECTORY, 
DELETE, PURGE, SORT, APPEND, DIFFERENCES, and UNLOCK. 


SET and SHOW commands described in Chapter 4 include SET PROTECTION 
and SET and SHOW DEFAULT. 


1.3.4 Handling Devices and Volumes 


Volumes are held on magnetic media, usually disks. The volume is in 
the RSX-11M/M-PLUS format, called Files-ll. The disks are mounted on 
hardware devices. Devices can be public, available to all users; 
shareable, available to some users but not others; or private, 
available to a single user only. 


All commands relating to volumes and devices are described in Chapter 
5% The commands include ALLOCATE, DEALLOCATE, ASSIGN, 
ASSIGN/REDIRECT, ASSIGN/TASK, DEASSIGN, MOUNT, DISMOUNT, INITIALIZE, 
-INITIALIZE/UPDATE, and BACKUP. 


SET and SHOW commands described in Chapter 5 include SHOW ASSIGNMENTS 
and SET and SHOW DEVICES. 
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1.3.5 Program Development 


RSX-11M/M-PLUS provides full facilities for program development, which 
are described in Chapter 6. The commands described include MACRO, 
BASIC, COBOL, FORTRAN, LIBRARY, and LINK. 


SET GROUPFLAGS and SHOW GROUPFLAGS are also described. 


1.3.6 Running Tasks 


The task is the fundamental executable programming unit on 
RSX-11M/M-PLUS. All commands related to running tasks are described 
in Chapter 7. 


RUN, ABORT, CONTINUE, CANCEL, INS 
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SET and SHOW commands described in Chapter 7 include SET and SHOW 
PARTITION, SHOW TASKS, SET PRIORITY, SHOW CLOCK QUEUE, and SHOW 
COMMON. 


1.3.7 System Control 


System control commands are described in Chapter 8. Most of these 
commands are privileged, but the SHOW commands described in Chapter 8 
are nonprivileged. 


Only SET and SHOW commands are described in Chapter 8. These include 
SET and SHOW SYSTEM/DIRECTORY, SET and SHOW LIBRARY/DIRECTORY, SET and 
SHOW [DAVY]TIME, SHOW MEMORY, SHOW USERS, SET and SHOW SYSTEM/POOL, and 
SET SYSTEM/[NO]LOGINS. 


1.4 USING THE QUEUE MANAGER: PRINT AND BATCH JOBS 


The RSX-11M/M-PLUS Queue Manager provides facilities for printing 
Files on line printers or other output devices. Files can be printed 
under user control or under the control of a system task or 
applications task. See the description of the PRINT command in 
Section 4.4.2. 


In? addition, “on” RaRS UE PROS: the Queue Manager provides oa 
“‘batch- processing facility... Batch. jobs°..use “the. ‘system without 
requiring you -to be present. This means that jobs that take a ‘long 
bime--(toe-scun, or otherwise. tie up system facilities, can be run when 
there are fewer’ demands, on the system, such as. at night or ..on 
weekends. ER see “i Bagg MERE Bo ‘Badig SE gaa 


All uses of the Queue Manager are described in a separate manual, the 
RSX-11M/M-PLUS Batch and Queue Operations Manual. The manual 
introduces and explains all the uses of the Queue Manager and _ the 
batch-processing subsystem. The manual includes sample print and 
batch jobs, full descriptions of commands to the batch processors, all 
commands for placing jobs in queues and displaying queue contents, and 
a complete description of the process of setting up the Queue Manager. 
In addition, the manual includes an explanation of writing tasks to 
spool output. 
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1.5 INDIRECT COMMAND FILES IN DCL 


In addition to the batch-processing subsystem, RSX-11M/M-PLUS provides 
the Indirect Command Processor (Indirect) as an alternative means of 
automatically passing commands to the operating system. If you have a 
series of commands to be executed in the same or similar fashion ever 
time, you can include these commands in a file to be run by Indirect. 


Indirect accepts not only DCL and MCR commands, but also. special 
directives that allow you to program the execution of the indirect 
command file. Indirect is described in full in the 
RSX-11M/RSX-11M/M-PLUS MCR Operations Manual. 


An indirect command file can include both MCR and DCL commands. Lt 
the file contains commands to both of these command line interpreters 
(CLIS), you must either prefix each CLI command with the CLI name, or 
change the CLI setting of your terminal before each CLI command. When 
your file has completed, reset the terminal to your usual CLI in the 
indirect command file. For example, if your terminal is set to DCL 
and you have MCR commands in your indirect command file, you can 
prefix each MCR command with "MCR," or set the terminal to MCR before 
each command and then reset it to DCL afterwards. 


1.6 DCL AND RSX-11M/M-PLUS UTILITIES AND SYSTEM TASKS 


The RSX-11M/M-PLUS Operating System includes a number of utilities and 
other system tasks designed to assist you in your use of the system. 
Most utilities are used to create or alter files in some way. 


Many DCL commands invoke these utilities transparently to the user. 
Just aS some DCL commands are passed to MCR, other DCL commands are 
passed to utilities. 


One important utility is PIP, the Peripheral Interchange Program, 
which is used to manipulate files. DCL functions such as APPEND, 
COPY, DELETE, PURGE, and DIRECTORY depend on PIP. As another example, 
the LINK command invokes the RSX-11M/M-PLUS Task Builder. Appendix B 
of this manual gives information on the relationships between DCL and 
the utilities and other system tasks. 


Each utility has its own command structure, but DCL commands allow you 
to use the most common functions of the most commonly used utilities 
without learning a new command set. For full access’ to the 
capabilities of the utilities, however, you may need to use them 
directly. To do this, you must run the utilities at your terminal. 
This is done with a RUN command in the form 


>RUN Sutl 


where utl is the 3-letter name of the utility. If you wish to access 
one of the utilities provided by Record Management Services-11l 
(RMS-11), use a command in the form 


>RUN SRMSutl 
where utl is the 3-letter name of the RMS-11 utility. 


Here is some information on each of the RSX-11M/M-PLUS and RMS-11 
utilities. RSX-11M/M-PLUS utilities are described in the 
RSX-1L1M/M-PLUS Utilities Manual. RMS-11 utilities are described in 
the RMS-11 documentation supplied with your system. Some system tasks 
that might be considered utilities, such as the Task Builder, are 
described in separate manuals. 
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Utilities described in the RSX-11M/M-PLUS Utilities Manual: 


PIP - Peripheral Interchange Program - a file transfer program 
that provides means for copying, concatenating, spooling, 
renaming, listing, deleting, and unlocking files. 


FLX - File Transfer Program - a file conversion program that 
provides means for transferring files from one operating 
system to another. Specifically, you can transfer files in 
DOS-11 and RT-11 format to RSX-11M/M-PLUS format (Files-1ll), 
and vice versa. 


DMP - File Dump Program - a file listing program that provides 
means for obtaining a printed copy of the contents of any 
file, including object files and task images, in any one of 
several useful formats. 


EDI — Line Text Editor - an interactive editing program _ for 
creating and maintaining text files on a line-by-line basis. 


SLP - Source Language Input Program - a utility that provides 
a means for maintaining and auditing source files. 


LBR - Librarian Program - a library maintenance program that 
provides a means for creating, modifying, updating, listing, 
extracting, and maintaining macro and object library files. 


VFY - File Structure Verification Program - a disk 
verification program that provides means for verifying the 
consistency and validity of the file structure on a Files-1l 
volume. 


PAT - Obtect Module Patch Program - a utility that provides 
means to patch, or update, a relocatable binary obiect module. 


ZAP —- ZAP Program - a utility that provides the means’ to 
examine and directly modify locations in a task image or data 
file. 


BAD - Bad Block Locator Program - a utility that provides 
means for determining the number and location of bad blocks on 
a magnetic medium holding Files-11l volumes. 


CMP - File Compare Program - a utility that provides the means 
for comparing two files and listing the differences between 
them. 


The RMS-11 utilities are provided as independent tasks to those who do 
not have full access to RMS-11 functionality, either because they are 
not programmers or are programming in a language other than MACRO-11. 


The RMS-11l utilities are: 


RMSBCK, a backup utility that transfers any RMS-11l disk file 
to another disk or a magnetic tape in a special format that 
cannot be read or modified by a user program. 


RMSCNV, a file conversion utility that moves records between 
two RMS-11 files of any organization or record format. 


RMSDEF, a file definition utility that creates RMS-11l files, 
defining their attributes in an interactive sequence of 
questions and requests for data. 
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@e RMSDSP, a display utility that lists the RMS-11 file 
attributes and structural data or the names of RMS-11 backup 
files on magnetic tape. 


@ RMSIFL, an indexed file load utility that builds an RMS-11 
indexed file using records from another RMS-11 file of any 
organization. 


@e RMSRST, a file restoration utility that reads the backup files 
created by the RMSBCK utility and restores them with form, 
structure, content, and attributes identical to the original 
Files. 


The RMSDEF utility is an interactive utility. That is, it performs 
its functions in response to a sequence of questions and requests for 
data. The remaining utilities are command utilities that operate by 
means of command strings input from the user's terminal. 


For descriptions of other useful and important system tasks, see the 
following manuals: 


@ RSX-11M or M-PLUS System Generation and Installation Guide - a 


description of the process of tailoring a system to a 
particular installation. 


@ RSX-11M/M-PLUS MCR Operations Manual - a description of MCR 
plus many details on system startup procedures and system 
operations, and a full description of the Indirect Command 
Processor. 


@e RSX-11M/M-PLUS Batch and Queue Operations Manual - a 
description Of the Queue Manager, which controls the orderly 
printing of files and other output, and the batch processing 
subsystem, a means of automatic use of the system. Batch 
processing is available on RSX-11M-PLUS systems only. 


e EDT Editor Manual - describes the use of EDT, the DEC Standard 
editor. The manual includes an introduction to EDT. 


@ RSX-11M/M-PLUS Guide to Program Development - a detailed 
introduction to the program development facilities, both DCL 
and MCR, of RSX-11M/M-PLUS. 


e IAS/RSX-11 MACRO-11 Programmer's Reference Manual - an 


introduction to the MACRO-11 Assembly Language and Assembler. 


@e RSX-11M/M-PLUS Task Builder Manual — a description of the task 
building, or linking, process in RSX-11M/M-PLUS. 


1.6.1 RSX-11M/M-PLUS DCL and VAX/VMS DCL 


DCL on RSX-11M V4.1 and RSX-11M-PLUS V2.1 and subsequent releases is 
designed to be compatible with DCL on VAX/VMS V3. If the function 
being performed is identical, the same DCL command will have the same 
effect on an RSX-11M/M-PLUS system or a VAX/VMS system. As other 
operating systems adopt DCL, the same will be true for them. 


In most cases, the default forms of DCL commands will have the same 
effect on either kind of system. Furthermore, many qualifiers are the 
same and also have the same effect. 
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On the other hand, operating systems that implement DCL, including 
RSX-11M and RSX-11M-PLUS, will have system-specific extensions to DCL. 
For example, RSX-11M/M-PLUS systems have several features not 
available on VMS-~ systems; DCL commands have been implemented to 
invoke these features. The command syntax for these features is 
different from any VMS command syntax to avoid confusion. 


In addition, many of the features discussed in this chapter are 
RSX-11M/M-PLUS extensions to the basic DCL language. Prompts, HELP, 
error messages, system displays, and command parsing (including 
abbreviating) are unique to RSX-11M/M-PLUS and may not be fully 
compatible with other DCL implementations. 


All the short forms abbreviations in 
DCL are intended for the convenience of 
interactive users at terminals. You 
should not use either these brief 
command forms, or other abbreviations 
shorter than four characters per command 


element, in indirect command files or 


any other permanent form. AS new 
commands are added to DCL, these 
abbreviations may change, but the 


full-—format commands are stable. 


CHAPTER 2 


THE SET AND SHOW COMMANDS 


The SET commands dynamically alter system characteristics. The SHOW 
commands display system characteristics. 


These commands affect every part of the operating system. Some of 
them are needed by every user every day. Others might not be used 
once in a year. 


SET and SHOW both prompt 
Function? 


There are more than 20 functions that can be altered or established 
with the SET command, and more than 20 others, not all of them the 
same, that can be displayed with the SHOW command. Most of the SET 
functions include options, values, or negations. 


Customarily, the SET or SHOW command and the function are considered 
to form a single command. That is, rather than speaking of the 
TERMINAL function of the SHOW command, you would refer to the SHOW 
TERMINAL command. 


Some of the most commonly used variations on the SET and SHOW commands 
are described for your convenience in Sections 2.1 through 2.12. 


Full descriptions of all the SET and SHOW command functions appear 
later in this manual. Each chapter concludes with the SET and SHOW 
commands appropriate to that chapter. Thus, SET and SHOW TERMINAL are 
described at the end of Chapter 3, Terminal Operations, and SET and 
SHOW DEVICES are described at the end of Chapter 5, Handling Devices 
and Volumes. See the Table of Contents for references. 


The following are the most commonly used SET and SHOW commands, 
described here in brief form for your convenience. All of these 
commands are described in detail elsewhere in this manual. 


2.1 SET AND SHOW TIME 


SET [DAY]TIME [hh:mm[:ss] ] dd-mmm-yy 
mm/dd/yy 


You can set both the time and the date with this privileged command. 
You can enter the date in either form, for example, 04-JUL-76, or 
7/4/76. In the latter case, mn stands for month number. No matter 
how you enter the date, it will be displayed in the first form. 


See Section 8.1.1. 
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SHOW [DAY] TIME 


This command displays the current setting of the day and time on your 
system. 


See Section 8.1.2. 


2.2 SHOW MEMORY 
SHOW MEMORY 


This command brings up the RMD display, which provides information on 
task activity, partitions, drivers, CPU usage, and so forth on your 
system. 


On video terminals, this display is dynamic. On hard-copy terminals, 
the command prints a snapshot of the current RMD display. 


The display provides a rough picture of the current state of the 
system. Alternate displays include the Active Task List or a single 
task header. 

Not all systems include this command for interactive use. Most 
systems, however, do run the display on a slaved video terminal 
somewhere near the computer. 

See Section 8.1.9 for more information on the memory display. See 


Section 7.12.3 for more information on the task list and task header 
displays. 


2.3 SET AND SHOW TERMINAL 
You can set and display many attributes of your terminal. The command 
SHOW TERMINAL 


without any qualifier, displays the current setting of all settable 
attributes of the terminal, as shown: 


TT5: [303,5] {303,5] 
CLI = DCL BUF = 132. HFILL = QO SPEED= (300: 300) 
LINES = 66. TERM = LA34 OWNER = NONE BRO NOABAUD 
LOWER NOPRIV NOHOLD NOSLAVE NOESC NOCRT HFF NOREMOTE 
ECHO NOVFILL NOHHT NOFDX WRAP NORPA NOEBC TY PEAHEAD 


The display is explained in full in Section 3.8.2. Here, briefly, are 
the more significant fields: 


Terminal number, login UIC, default UFD 


CLI Current CLI setting 

BUF Buffer-length, that is, the width in columns 

SPEED Transmit and receive speed 

LINES Page length in lines 

TERM Terminal model 

OWNER Tells whether terminal has been allocated 

BRO Terminal can receive broadcast messages 

NOPRIV Terminal is not privileged 
The SET TERMINAL command permits you to set most of these attributes 
for your terminal. Privileged users can set the attributes of any 
terminal. 
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The format of the SET TERMINAL command is: 
SET TERMINAL/attribute[/attribute[s] ] 


Note that you can set more than one attribute at a time. A command 
such as the following: 


“SET TERMINAL /YTLOO/LOWERCASE/DCL 
is accepted by the system and executed. 


Here is a summary of the most important attributes you can Set: 


JDCL /MCR / UPPERCASE / LOWERCASE 
/PAGE LENGTH:n /WIDTH /SPEED: (transmit,receive) 
/{NO]BROADCAST /[NO] PRIVILEGE /SCOPE /HARD COPY 


You can also set your terminal as a particular model: 


/ASR33 /LA36 /VT05 /VT102 
/ASR35 /LA38 /VT50 /VT105 
/KSR33 /LALOO /VT52 /VT125 
/LAL2 /LA120 /VT55 /VT131 
/UA30P /LAL80S /VT61 /VT132 
/LA30S /RTO2 /VT100 

/LA34 /RTO02C /VT101 


See Section 3.8 for more information on the meaning of these 
attributes. 


2.4 SHOW DEVICES 
SHOW DEVICES 


This command displays the name and other information for all devices 
known to the system. 


SHOW DEVICES dd: 


This command displays the name and other information for all devices 
of a particular type known to the system, where dd is the 2-letter 
mnemonic for the device type or pseudo-device type. See Section 
5.1053 


2.5 SHOW QUEUE 


This command displays information about the queue file maintained by 
the Queue Manager. Two forms of this command are most useful. 


SHOW QUEUE 


This command displays information about all jobs in ail queues. In 
addition to showing all queue assignments, the information display 
includes all Queue Manager QMG jobs and all files included in those 
jobs. 


On RSX-1IM-PLUS systems, this display includes batch queues as well as 
print. queues. : nes ae ae : 
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SHOW QUEUE/FULL 


This command displays full information about all jobs in all queues. 
In addition to the information displayed by SHOW QUEUE, SHOW 
QUEUE/FULL displays all the attributes of all the QMG jobs in the 
queue, such as /FORMS, /COPIES, and /PAGE LENGTH. 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual for more 
information on the SHOW QUEUE commands. 


2.5.1 SHOW PROCESSOR 


SHOW processortype processorname[/qualifier[s] } 


BATCH 

CARD READER 

DEVICE 

INPUT 

PRINTER 

PROCESSOR 
This command displays information about the card readers, batch 
processors, printers, and other devices under the control of the Queue 
Manager. 
CARD READER and INPUT are synonyms. DEVICE refers to all nonbatch 
output processors and is a synonym for PRINTER. BATCH refers to all 
batch processors. (Batch processing is available only on 
RSX-L1IM-PLUS.) 
A simple SHOW PROCESSOR command displays all processors in the system. 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual for more 
information. 


2.6 SHOW ASSIGNMENTS 
SHOW ASSIGNMENTS[:ttnn:] 


This command displays at your terminal all local and login 
logical-device assignments. See Section 5.10.1. 


2.7 SET AND SHOW DEFAULTS 
SET DEFAULT: [ddnn:] [g,m] 
where 
dd 
The 2-letter device mnemonic 
nn 


The l- or 2-digit device number terminated by a colon 
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[g,m] 


The UFD is two octal numbers separated by a comma and enclosed 
in brackets. 


This command alters your default settings for device and User File 
Directory (UFD). 


The default device name and UFD are included automatically in every 
filespec included in a command unless overridden. See Section 4.5.1. 


SHOW DEFAULT 


This command displays your current default device and UFD. See 
Section 4.5.2. 


2.8 SHOW TASKS 


This command displays information about tasks in the system. Four 
forms of the command are most useful. 


SHOW TASKS/ACTIVE 
This command displays information about the tasks active at your 
terminal. 


SHOW TASKS/ACTIVE/ALL 


This command displays information about all tasks active on the 
system. 


SHOW TASKS/INSTALLED 


This command displays full information about all tasks installed on 
the system. 


SHOW TASKS/ACTIVE FULL taskname 
or 
SHOW TASKS/INSTALLED FULL taskname 


These commands display full information on a single active or 
installed task. See Section 7.12.5. 


2.9 SHOW USERS 
SHOW USERS 


On RSX-11M, this command displays the terminal number and login UIC 
for each logged-in terminal. 


On RSX-11M-PLUS systems without Resource Accounting, this command 
displays the terminal number and login UIC for each logged-in 
terminal. 


On RSX-l11M-PLUS systems with Resource Accounting, this command also 
displays for each logged-in terminal the default UFD, the date and 
time of logging in, the number of currently active tasks, and the 
user's name. 
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2.10 SET PROTECTION 


SET PROTECTION filespec[s] 
Protection? (SYSTEM: RWED, OWNER: RWED, GROUP: RWED,WORLD:R) 


This command alters the access protection of a file or files. If you 
wish to protect more than one file, the filespecs must be separated by 
commas. 

There are four kinds of access to files and four classes of users who 
may access files. The previous example shows the the code for the 
default protection used on the system. 

The four classes of users who may access files are: 


SYSTEM Privileged users and the operating system itself 


OWNER Users logged in under the same User Identification Code 
(UIC) the file was created under 


GROUP Users logged in under the same group number as the UIC 
the file was created under 


WORLD All other users 
The four kinds of access to files are: 


R READ access. The file can be typed, printed, copied, run (if 
a task image), and so on. 


W WRITE access. The file can be written to or altered. 

E EXTEND access. The file size can be changed. 

D DELETE access. The file can be deleted. 
These kinds of access are in hierarchical order. This means if you 
grant Delete access to a class of user, you are granting Read, Write 
and Extend access as well. 
The protection status shown at the beginning of this section is’ the 
default protection status accorded every file on the system. Use SET 
PROTECTION to change the protection status of files. 
You must enter the class of user and the type of access in the form 
shown. If you do not wish to change the access rights of a particular 


class of user, simply leave that class out. 


All users can set the protection of their own files. Privileged users 


can set the protection of any file. Note that you can set the 
protection of a file so no user, including yourself, can do anything 
with the file. If you do this, you will need a privileged user to 


reset the protection when you wish to use the file. 


You can display the protection of a file with the DIRECTORY command 
and /FULL qualifier. See Section 4.5.3. 


2.11 SET AND SHOW SYSTEM/DIRECTORY AND LIBRARY/DIRECTORY 


The Executive, privileged system tasks, and other system files are 
kept together in a single User File Directory (UFD) called the System 
UFD. In most cases, this will be UFD [3,54] on the system disk. An 
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TERMINAL OPERATIONS 


The terminal is your main channel of communication with the computer 
system. The information in this chapter tells you how to use a 
terminal to communicate and interface with the RSX-11M and 
RSX-11M-PLUS Operating Systems. For a quick review of basic 
operations at a terminal, refer to the Introduction to RSX-11M and 
RSX-11M-PLUS. 


The discussions in this chapter are organized around three DIGITAL 
terminals: the LA36 hard-copy terminal (DECwriter II) and the VT52 
and VT100 video display terminals (DECScopes). These terminals do not 
always behave in exactly the same way; variations are noted in the 
descriptions of terminal functions in this chapter. If you are using 
another type of terminal, check with your system manager for special 
instructions. In any case, you should read the manual shipped with 
your terminal to get full use of your terminal on the system. 


A typical terminal keyboard is shown in Figure 3-1. A keyboard is a 
set of alphanumeric keys, similar to the set on a typewriter. The 


keypad shown in the illustration is a set of special keys. Where 
pertinent, the functions of these keys will be explained in this 
chapter. All terminals will have some form of a keyboard; some 


terminals will not have the keypad. 
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Figure 3-1 Terminal Keyboard and Keypad 
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Each terminal on an RSX-11M/M-PLUS system has a number. Your terminal 
number is displayed when you log in. Your terminal number is also 
used by the system to identify tasks run from your terminal. (See 
Section 7.1.1 for more information on task naming.) 


TERMINAL OPERATIONS 


You can set many characteristics for your terminal using the SET 
TERMINAL command (Section 3.8.1). The characteristics of your 
terminal can be displayed with the SHOW TERMINAL command (Section 
SoS 2)s In addition, the SHOW USERS command (Section 8.1.8) displays 
the terminal number, default UFD, and login UIC for each logged-in 


user. 


systems. with Resource Accounting _ active, ‘SHOW USERS 
: “and... “number oe eter cn ely ctive. 


Frequently, users work from more than one terminal. You can always 
use the pseudo-device name TI: to refer to the terminal you are 
currently using. You do not need a specific number. In most cases, 
when a system task requires you to name an output file, you can 
specify TI: and the output will be printed on your terminal. 


A terminal is said to be attached if all its input and output is 
directed to or from a task. If you invoke a task, it may attach your 
terminal so that no other task can use the terminal for I/O. When you 
exit (for example by typing CTRL/Z), the task detaches the terminal. 
When you are using an editor, the editor has your terminal attached. 


Terminals may also be dedicated exclusively to a task. Such terminals 
are called slaved terminals. Tasks can slave terminals, or terminals 
can be set slaved through the SET TERMINAL command. Terminals can 
also be set slaved on logging in. Slaved terminals can communicate 
only with tasks soliciting input from the terminal. 


3.1 LOGGING IN AND LOGGING OUT 


Your terminal must be connected to the system hardware and the system 
software before you can use it. You can assume it is connected to the 
hardware. Connecting to the software is called logging in; 


disconnecting from the software is called logging out. 


Logging in informs the system that you will be using a terminal. 
Logging out informs the system that you are through using a terminal. 


Most terminals have an accessible on-off switch. This switch supplies 
power to the terminal, but it has no bearing on whether the terminal 
is logged in. If you turn the power switch off, a logged-in terminal 
remains logged in. 


You can test whether a terminal is turned on and available by pressing 
RETURN or CTRL/C. The RETURN key causes the right-angle-bracket 
prompt (>) to appear. The CTRL/C causes the explicit prompt (DCL> or 
MCR>) to appear. 


The SHOW DEFAULTS command tells you whether the terminal is logged in 
Or not. If it is not logged in, the command produces an error 
message. If it is logged in, the command displays the current default 
device and UFD. 


If the terminal is already logged in, you should type CTRL/C to 
determine whether the terminal is set to DCL or MCR. If the terminal 
is set to MCR, type in ACT as shown: 

MCORZACT 


If the terminal is set to DCL, type in SHOW TASKS/ACTIVE as shown: 
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LOGIN 


This command will inform you whether the terminal is in active use or 
not. It is not good practice to take over a terminal while another 
user has tasks (other than CLIs) active at the terminal, aS you may 
interfere with the other user's work. Check also with SHOW DEVICES to 
see if the other user has devices allocated or volumes mounted. 1 
the other user has no significant activity under way, use your own 
judgment as to whether you should log the other user out, using either 


RCLSLOGOQUT 
or 
MCRORYE 
and, after the terminal is logged out, log yourself in. 
If you are not sure how to log in, type HELP for help in logging in. 


If the terminal is not logged in, you may log in. Unlogged-in 
terminals are not set to either DCL or MCR. You can log in to an 
RSX-11M/M-PLUS multiuser protection system using either HELLO or LOGIN 
together with your User Identification Code and your password. The 
system's Account File Maintenance Program (ACNT) identifies each user 
as either a DCL or MCR user and sets the terminal accordingly. See 
the description of LOGIN (Section 3.1.1) for further information on 
the effects of logging in. 


Remember, you can change the CLI of your terminal from DCL to MCR _ or 
vice versa with the following commands: 


NCRSSET /0CL=TIL: 
or 
DQCLSSET TERMINAL /MCR 


All RSX-11M/M-PLUS systems with DCL are multiuser protection systems. 
This means that the system includes features, such as LOGIN and LOGOUT 
and ALLOCATE (Section 5.4), that enable many users to use the system 
without interfering with each other's work. 


3.1.1 LOGIN 

LOGIN grants access from a terminal to a multiuser protection system. 
LOGIN also establishes certain characteristics of your terminal 
session. 


Format 


LOG[IN] 
userid 
Password: password 


LOGIN userid 
PASSWORD: password 


LOGIN uic/password 
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LOGIN (Cont.) 


Parameters 
userid 


Specifies the User Identification Code (UIC) of the user logging 
in. Five forms of UIC are accepted by this command: 


{[g,m] 
g,m 

[g/m] 
g/m 


name 


If you log in with a comma in the UIC, or if you log in by name, 
a file called LBO:[1,2]LOGIN.TXT is printed on your terminal. 
This file is prepared by your system manager and usually contains 
information about the system and other announcements. If your 
system displays such messages, using a slash (/) instead of a 
comma (,) between the group and member numbers suppresses these 
messages. 


Your system may also have a file called LBO:[1,2]SYSLOGIN.CMD. 
This file can contain a number of system-level commands that your 
system manager wishes to have executed each time a user logs in. 


Finally, you, as an individual user, can prepare a file called 
LOGIN.CMD to be kept in your UFD (User File Directory) to be 
executed each time you log in. This LOGIN.CMD file usually 
includes commands for setting up the terminal and the account for 
regular use. 


The LOGIN command interacts with the Account File Maintenance 
Program (ACNT) to establish a number of characteristics of the 
terminal session you are beginning. These include your default 
device (where your files are located), an indication of whether 
your account is privileged or not, and whether your terminal is 
to remain slaved after login. See your system manager for 
information on how this will affect you. 


password 
Your password is limited to six Radix-50 characters. If you 
enter your password in response to the Password: prompt, your 
password is not echoed on the screen. If you type in your 


password on the same line as your UIC, the password is echoed. 
Your password is established by your system manager as part of 
setting up your account. 


Examples 
>LOGIN 
Account or neme sy KRAFKA 


Fsssword? 


ROX-LIM-PLUS VO2 BLIS Multiuser (€3,541] Svestem 
20-Nov-82 09716 Logded om Terminal TTS4? 


Good Mornins 


November 20, 1982 System Manesger 
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LOGIN (Cont.) 


** DISK-TO-DISK BACKUFS *&x* 
Flease rurse your files!llili br btr red br red rr bitter 
November i: 1982 Orerator 


Mestere drive MM1li is down until furtner notice. 


In this example, full login text is automatically printed on the 
terminal because the user logged in with a name (KAFKA). The 
full login text is also printed if you log in with a UIC entered 
with a comma [g,m]. See next example. 


the prompt siaqnifies the completion cf logging in. 


“LOGIN 4203/5 
Faessword? 


RSGX-LIM-FLUS VO2 BLISS Multiuser [C3954] Sustem 

2O-NOV-B2 09318 Logsed on Terminal TTSé: 

Geod Morning 

November 207 1982 System Manager 

#*X Sustem will be down tonight from 21:00 to 24300 xx 
#k DPISK-TO-DISK BACKUPS x 


Flease rurde vour fileslilibibba rbd rbrb rtp tt baibibidaa 


This example shows the first login of the day for this user. The 
UIC was entered with a slash (303/5). The printing of the system 
LOGIN.TXT file in full was therefore suppressed. Only the first 
message (defined as being a priority message by the system 
manager) was printed. The priority message is printed only on 
the first login of the day. This ensures that users who 
habitually log in with the slash do not miss anything. See next 
example. 


“LOGIN 303/75 
Fassword? 


RSX-LIM-FLUS VO2 BLIS Multiuser (€3:54] System 
2O6-NOV-82 10:36 Logsed on Terminal TTS4: 


Good Morning 


This example shows a subsequent login on the same day by the same 
user. Note that no system messages are displayed. 
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LOGIN (Cont.) 


>LOGIN 
Account or mame! 301/370 
Fessword? 


RSX-1L1IM-PLUS ¥O2 BLISS Multiuser €3:9541] System 
2O-NOV-82 193346 Lodged on Terminal TT45! 


Good Evenings 


~@LOGIN.CMD 

“SET TERMINAL/LOWER 
PASSION RSS DRI: 
>B<EOF > 


This user has prepared a LOGIN.CMD file in his UFD to set up_ the 
terminal and make a logical assignment. The LOGIN.CMD file is 
run automatically each time the user logs in. The commands shown 
are issued by the indirect command file; the @<EOF> marks the 
end of the command file. 


Notes 


LOGIN and HELLO are identical. LOGIN does not work on systems 
without DCL, however. 


LOGOUT counteracts LOGIN. 


raen) 
~ 


Ou 
3 


one re) nd the system display has been printed on 
your terminal, the system searches the User File Directory you 
logged in to for a file named LOGIN.CMD. This indirect command 
file can contain any commands you wish. This feature is commonly 
used to set up your terminal for regular use, as shown in the 
example. See the RSX-11M/M-~PLUS MCR Operations Manual for more 
information on indirect command files. 


q = 
the a 


It is wise to log in occasionally without the slash to be sure 
you have not missed any important messages. 


Error Messages 


MCR -- Not logged in 
DCL -- Not logged in 


Explanation: The terminal is not logged in. 
User Action: Log in using either LOGIN or HELLO. 
LOG -- Account file open failure 


Explanation: The system could not access the account file for 
some reason. 


User Action: Try again. Wait and try again. If the message 
recurs, see your system manager. 
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LOGOUT 


LOG -- Invalid account 


Explanation: The name or UIC, or the password, given in the 
command is not recorded in the account file. 


User Action: Retype the command using correct data. 
LOG -- Logins are disabled 


Explanation: The system is being shut down, or a privileged user 
has issued SET NOLOGINS for some other reason. 


User Action: You cannot log in. Try again later. Often, when 
logins are enabled again, the operator sends a message to all 
terminals. 


LOG -- Other user logged on 


Explanations Another user is logged in. Only one user at a time 
can log in on a terminal. 


User Action: Issue SHOW USERS to find out who is logged in. 
Issue SHOW TASKS ACTIVE to find out what tasks are active on the 
terminal. At your discretion, issue LOGOUT and then log yourself 
in. 

LOG -- Terminal allocated to other user 


Explanation: The terminal has been allocated (made private) by 
another user. You cannct log in on an allocated terminal. 


User Action: Go to another terminal. Issue SHOW DEVICES TT: 
and find out which terminal has your terminal allocated. 


3.1.2 LOGOUT 
LOGOUT logs the user off a multiuser protection system. 
LOGOUT also aborts any active nonprivileged tasks running from _ the 
terminal as well as dismounting any private volumes and deallocating 
any private devices allocated from the terminal. 
Format 
LO[GOUT] [/HOLD] 
NO prompts. 
Command Qualifier 
/ [NO] HOLD 
The /HOLD qualifier is for use on remote or DECnet host 
terminals. If you include the qualifier, the terminal is logged 
out but the line is not hung up. This means you can log back in 


without reconnecting the line. The default is /NOHOLD, meaning 
that when you log out, the line is also hung up. 
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LOGOUT (Cont.) 


Examples 


»LOGOUT 
Have s.doo0d sfternoaon 
O4-NOV-820012513. TTISt. -Lossed off. ZENITH 


In this example, the user. logged off an RSX-11M system. The 
.terminal..-is -free. for. logging in... ZENITH is a DECnet node name. 
This information /does not. appear .on systems without DECnet 


support. © 
>LOGOUT ie Gay es 
‘Cormeet Vinet aa @iuutes ie oe 
CPU TINE USERS 256. seconde. (2) so, 
Task total? 90. gE are a ee 


Have 3. good aniainoann 
oB- SEP- -92. 163 aa EOS 


n -RSX-11M-PLUS system. The 
ted | on systems without 
is free. ae suioiailees 


In Chis example, ten us 
-information (on system 
Resource Accounting rw 
in... (PRINCE .is..a DECnet 


yLOGOUT 

QMO -- T1160? Dismounted from DX0} 
Connect time? $2 minutes 

CPU time used? i2 0 6seconds 

Task total? 2i 


Have 3 good morning 
OS-SEF-82 LLiti?y TTio3} Lodsed off ROMWFER 


In this example, the user had a volume mounted on device DxX0:. 
The LOGOUT command dismounted the volume, as the message states. 
If the device was allocated, the LOGOUT command will deallocate 
it, but will not issue a message. 


LOGOUT 
T2I29t36 Task "TT190 " Terminated 
Aborted vis directive or CLI 


Have a good efternoon 
LP-NOV-B82 13713 j%q; TT T1903 Lossed off 


In this example, the user had a task running from the terminal at 


the time the LOGOUT command was issued. The command caused the 
task to be aborted. 


Notes 
LOGIN counteracts LOGOUT. You need type only LO to log out. 
The LOGOUT command works only on terminals set to DCL. If the 


terminal is set to MCR, use the BYE command. Type a CTRL/C to 
find out which CLI the terminal is set to. 
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3.1.3 ACNT, the Account File Maintenance Program 


Account files on RSX-11M and RSX-11M-PLUS are created and maintained 
by ACNT, the Account File Maintenance Program. Whenever a user tries 
to log in, the system checks the user identification and the password 
against the account file to determine whether the user should be 
allowed access to the system, and with what privileges. 


The account file describes all the UICs and associated passwords that 
have been authorized for a multiuser protection system. ACNT also 
associates a CLI (usually DCL or MCR) and a default device with each 
user. 


Privileged users have full access to the functions of ACNT, as 
described in the RSX-11M/M-PLUS System Management Guide. 
Nonprivileged users can change their password with ACNT if Resource 
Accounting is active on the system (see the RSX-11M/M-PLUS MCR 
Operations Manual for more information) but should see the system 
manager to change other aspects of their account. 


You should not confuse ACNT with Resource Accounting, which is 
described in Section 3.1.4. 


3 i. a Resource” accounts 


Je oBCCOUNLING=<..0 aS o0 2a 
of information on system. 
dual-- user: and for. the 


RSX-11M-PLUS : ayetoas: 
system-generation. option 
‘use. Data is Setberes: bo 
BASES eS nae 

when: you: 46a in, ae bee fi 
password, Resource “Ace 
‘session. This” number. ca 
‘personal identifier. Th 
is neneE! Tee. Bae the “numb: 
logged ain “two | ‘term 
number - aes ‘thie Sanic. personal. identifier. - 


dity Es “your: -UIC.and 
Sur ae ee terminal. 
os, ne 3- -character 
‘ace ‘the. caaes session 
Poe TE you. ane 


When: ‘you ‘Log ‘out, ‘Resource: “Aecounting. aiapis gas the. time. ae were 
logged in, the CPU time. used, and the number OE. tasks. used. 


Users can ide aiepiay Siecent: Re curae accounting. ay with the 
soumand SHOW ACCOUNTING/ INFORMATION, described Aine the ext Sectlonec:. « 


The: data gathered by. Resource ‘agemuntiad? “Wakes “possible billing: i 
individual users for the system resources used and measurement: Of. 
overall System BSage +. rah th cs 


For Further ieeormacton on Resdurée Accounting, see the RSX- 11M/M- PLUS 
System Management Guide. 


3.1.4.1 SHOW ACCOUNTING/INFORMATION 


SHOW aceon teiriccirosaon ley current, Snéotmationston terminal 
session. Privileged users 


“ this’ information for any 
terminal session. Nonprivil display information. about 
their own. terminal sessions.” ie 
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3.2 THE KEYBOARD 


Most of the keys on the main keyboard are self-explanatory. They 
function much the same as they do on a typewriter. Only the most 
important differences from typewriter operation are noted here. See 


Table 3-1 for the names of keyboard characters as used in system 
documentation. 


You should remember that a computer terminal is not a typewriter. A 
computer terminal has two functions, transmitting input to the 
computer and receiving output from the computer. Usually, when you 


press a key, the letter appears immediately on your terminal. When 
you pressed the key, you sent a character to some system task or 
program. One of the actions the system normally takes upon receiving 
a character is to send it back to your terminal as an_ echo. This 
usually happens so fast that it appears that you are typing on your 
terminal, but you are not. You are sending input to the system and it 
is sending output to your terminal. A terminal is an input/output 
device. 


Occasionally, when heavy demands are being made on the system, there 
may be a noticeable lag between the input and the echo. 


You should also remember that keys may behave differently when sending 
output to some task other than DCL. For instance, all the keypad 
keys, plus the ENTER, BACK SPACE and LINE FEED keys, have’ special 
meanings when you are running EDT, the DEC Editor. Special 
applications software at your installation may also use _ special 
meanings for certain keys. This chapter covers key use for DCL, also 
called monitor level. 
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3.2.1 RETURN and Command Line Length 


The RETURN key has two functions. It is used in the conventional way 
to supply a line feed and a carriage return, but the key is also used 
to signal the system that you have finished typing a command. 
Commands can be quite varied in length; the RETURN key defines the 
length of the command. The symbol <RET> is used in this manual to 
signify that you press the RETURN key. Thus, 


*PRINT IZZ¥.TXT @ED 
is a complete command, and so is 
SFRINT/COPITES? 2/FORMi{L/DELETE IZZ¥.TXT @eT 


If you must enter a command that is longer than a single line on your 
terminal, you can override the effect of the RETURN key by ending the 
line with a hyphen before pressing the RETURN key. This works as 
follows: 


SFRINT/COPIES?2/FORM{i/DELETE IZZY.TXT» OZY.TXTs MADISON. AVE» — QE) 
~e/FUZZY.TXT#i2, GUNGA.DIN2 ET 


The hyphen tells the system to postpone execution of the command until 
it receives a carriage return not preceded by a hyphen. In the 
example given, the user had more files to be printed together than 
could be specified on a single line. The hyphen called for the 
special continuation prompt (->) rather than execution of the command. 
The carriage return without the preceding hyphen then called for 
execution of the full command. For more information on command line 
continuation, see Section 1.2.13. 


NOTE 


In most examples and command formats in 
this manual, the carriage return at the 
end of a line containing a command or 
command element is assumed and is not 
shown. 


3.2.2 Line Terminators 


You can terminate a command line with either the RETURN key, or with 
the key variously labeled ESC, SEL, or ALTMODE. CTRL/Z and CTRL/C are 
also line terminators. Each of these terminators has different 
effects. The RETURN and ESC keys are discussed here. The control 
characters are discussed in Section 3.4. 


The ENTER key on the keypad is identical with RETURN at DCL monitor 
level. 


When you terminate a command line with the RETURN key, as soon as'~ the 
command is processed, the implicit DCL prompt reappears, ready for 
another command. For example: 


*SHOW TIME (RET 
O9FPSPI21 13-EC-82 


You need not wait for the return of the prompt to enter another 
command. 


3-12 
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When you terminate a command line with the ESCAPE key, DCL does not 
prompt after the command has been processed. For example: 


> SHOW TIME €S0 
1O0305:38 13-DEC-82 


The cursor or print head appears at the beginning of the line with the 
time on it. 


The LINE FEED key provides a line feed without a carriage return. It 
cannot be used as part of the command line and is not a terminator. 


3.2.3 DELETE Versus BACK SPACE 


You should avoid the BACK SPACE key. This key is included = on 
terminals for compatibility with other systems but is not used in DCL. 
The BACK SPACE key does not produce an echo, but it can have confusing 
results when used in a file or when entering a command. When you make 
a typing mistake, use the DELETE key to correct it, not BACK SPACE. 
(The BACK SPACE key may be used for special functions within tasks 
such as EDT.) 


The DELETE key (labeled RUBOUT on some terminals) works in a_ slightly 
different fashion on video and hard-copy terminals. 


On hard-copy terminals the DELETE key removes the last character typed 
and then verifies the removal by repeating the removed character on 
your terminal preceded by a backslash. This action is repeated each 
time you press the DELETE key. For instance, the sequence 


>RUM FEEBER G&D O& LE 

appears on a hard-copy terminal as 
7RUN FEEBERSNRENLE 

But the operating system receives the command: 
“RUN FEEBLE 


You can verify this by typing a CTRL/R after the corrected line to 
retype it properly, without the intervening deleted characters, thus: 


[RUN FEEBERNRESLE CLR 
SRUN FEEBLE 


On a video terminal, the DELETE key actually erases the last character 
typed on your screen and you can replace it directly. The deleted 
characters are not repeated. For instance, 


>RUN FEEBER OG 2 LE 
The sequence appears on a video screen in succession as follows: 


“RUN FEEBER 
-RUN FEEBE 
“RUN FEER 
RUN FEEBL 
RUN FEERBLE 


If you are using an editor that permits you to move the cursor around 
on the screen, the DELETE key deletes the first character immediately 
to the left of the cursor location. 
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3.2.4 CAPS LOCK and SHIFT 


On most video terminals, the CAPS LOCK key causes all letters to _ be 
typed in uppercase. This key affects only letters, not numbers or 
symbols. You can engage CAPS LOCK and type 'RSX-11M-PLUS' without 
disengaging it, even though the numbers and the hyphens are lowercase. 


The SHIFT keys set your terminal to uppercase for the keys not 
affected by CAPS LOCK, as well as for individual alphabetic 
characters. 


On most hard-copy terminals, CAPS LOCK sets all keys to uppercase. 


Different terminal models vary widely in their treatment of CAPS LOCK 
or the equivalent key. You should experiment on your terminal. 


3.2.5 REPEAT 


The REPEAT key on the VT52 and LA36 repeats the action of any other 
key. You can use it to insert a series of blanks, characters, 
carriage returns, or whatever. Use it by holding down REPEAT and the 
key whose action you wish to repeat. It is particularly handy with 
the DELETE key. Normally, a DELETE-REPEAT combination deletes back to 
the left margin of your terminal and no further. 


Most keys on the VT100 repeat automatically. if you keep the _ key 
depressed. There is no REPEAT key on the VTI1OO. 


3.2.6 SCROLL and NO SCROLL 


The SCROLL key on VT52s is used together with the SET TERMINAL/ 
HOLD SCREEN command. This command limits the terminal to one 
screenful of information at a time, allowing you to read output that 
requires more than one screen's worth of space. If HOLD SCREEN is 
set, the SCROLL key moves the display up one line at a time. SHIFT 
and SCROLL together bring up a new screenful of information. (A 
CTRL/C or SET TERMINAL/NOHOLD SCREEN returns the terminal to normal.) 


The NO SCROLL key on the VT100 simply causes the terminal to stop 
scrolling. When you are ready for the terminal to scroll, press the 
NO SCROLL key again. 


See also the discussion of the CTRL/S and CTRL/Q keys in Section 
3.4.2. 


See the documentation provided with your terminal for information on 
controlling scrolling on other terminal models. 


3.2.7 Other Keys 
The COPY key is used only on terminals with a copier. 


Other keys are listed in Table 3-1, along with common names for them. 


Character 
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Table 3-1 


Keyboard and Keypad Characters 


Name 


Circumflex 


Right-angle bracket 


Greater-than 


Implicit monitor 
Prompt 


Left-angle bracket 


Less-than 


Period 
Decimal point 


Dot 


Comments 


On some keyboards, this 
character appears as an 
up-arrow. It should not 
be confused with the 
cursor-control keys on the 
keypad, which also have 
arrows. 


At monitor level, the CTRL 
key sometimes echoes as a 
circumflex when struck in 
combination with a letter. 


If you wish to include 
CTRL/a characters in a 
batch job, the letter 
preceded by the circumflex 
will be treated as a 
CTRL/a. 


In BASIC programs, the 
circumflex is the 
mathematical operator for 
exponents. 


General term. 


ASCII name of character. 
Used in mathematical and 
logical expressions. 


At monitor level, 
Signifies that system is 
ready to accept commands. 
The explicit monitor 
prompts are MCR> and DCL>. 


General term. 

ASCII name of character. 
Used in mathematical and 
logical expressions. 

In text. 


In numbers. 


In filespecs, terminator 
between file name and file 
type. 


The period keys on the 
keyboard and keypad are 
identical at monitor 
level. 


(continued on next page) 


Character 
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Table 3-1 (Cont.) 
Keyboard and Keypad Characters 


Name 


At sign 


Commercial at 


Number sign 


Percent sign 


Wildcard 


Asterisk 


Wildcard 


Underscore 


Hyphen 


Minus 


Plus 


Colon 


Equal sign 


Braces 


Parentheses 


Comments 


Indirect command file 


operator. 


ASCII name. Not in the 


international character 
set. 

Not pound sign. 

General term. 

Stands’ for "match one 
character in this 
position” in file names 


and file types. 
General term. 


Stands for "match any or 
no characters in this 
position" in file names 
and file types, or for any 
group, member, or version 
number. 


Used to tie command words 
together in DCL. 


DCL continuation 
character. Used for 
command lines too long for 
terminal line. Overrides 


RETURN. Command not 
entered until monitor 
receives RETURN without 


preceding hyphen. 


Mathematical operator for 
subtraction. 


Mathematical operator for 
addition. 


Marks beginning of 
argument in DCL command. 


Mathematical and logical 


operator. Also used 
extensively in MCR syntax. 


(continued on next page) 
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Table 3-1 (Cont.) 
Keyboard and Keypad Characters 


Character Name Comments 
[] Square brackets Delimiters for UIC and UFD 
numbers. 
Z Slash Marks beginning Of 


qualifier in DCL commands. 


Must be preceded by space 
in MCR commands. 


\ Backslash On hard-copy terminals, 
delimiter for deleted 
characters. 


3.3 THE KEYPAD 


Some terminals have a second set of keys to the right of the main 
keyboard, arranged much like a bookkeeper's keypad. These keys make 
up the keypad. 


The keypad keys are available for special functions. Some functions 
of the operating system use these keys. They may be used in many 
other ways, depending on the particular installation. The following 


description covers only the uses of the keypad by functions at the 
monitor level. 


The keypad numbers work in the same way as the numbers on the regular 
keyboard except that the symbolic characters are not available from 
the keypad. 


The period key works in the same way as the period on the _ regular 
keyboard. It is used for including the decimal point in numbers. 


The ENTER key works the same as the RETURN key on the main keyboard. 


The three blank keys on the VT52 are reserved for special functions. 
They are not used at monitor level. The same is true of the PF keys 
on the vT100. 


The four "arrows" are used for cursor control by EDT, the DEC Standard 
Editor, but are otherwise available for special functions. 


The blank, PF, and cursor-control keys can have seemingly paradoxical 
effects if struck carelessly or accidentally. These keys each send an 
ESCAPE character and one or more characters to the operating system. 
The ESCAPE is a nonprinting character, but the associated letter can 
be echoed on the terminal and may make the operating system behave as 
if you had typed that letter. 


Here is how these special keys are set up on the VT52: 


up-cursor types A 
down-cursor types B 
right-cursor types C 
left-cursor types D 
blue blank types P 
red blank types Q 
gray blank types R 
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If, for instance, you were to type a down-cursor while in DCL mode, 
you might find yourself being prompted To? because the down-cursor 
key sent a B to DCL, which interpreted it as the short form of the 
BROADCAST command. (To exit from any command or prompt, type a 
CTRL/Z.) 


Here is how these special keys are set up on the VT100: 


up-cursor types [A 
down-cursor types [B 
right-cursor types [C 
left-cursor types [D 
PFl types OP 
PF2 types OQ 
PF3 types OR 
PF4 types OS 


3.4 THE CTRL KEY AND CONTROL CHARACTERS 


The key marked CTRL is called the control key. It is used much like 
the shift key on a regular typewriter. If you hold down the CTRL key 
and then press another key, you are sending a command to the operating 
system. The CTRL key alone has no effect. 


The combination is designated by CTRL/a, where a is the chosen letter 
Key. 


When the combination is echoed on your terminal, the CTRL key is 
represented by the circumflex (*). Type a CTRL/U and you see a “U on 
your terminal. 

The operating system recognizes 11 letters combined with the CTRIL key. 
The letters are C, I, kK L, O, Q, R, S, U, X, and Z. These are 
discussed below in approximate order of importance. 


With the exception of CTRL/Z, the control characters are commands 
directed to the operating system and not to any task you may be 
running from your terminal. This means that they usually work without 
interfering with such tasks. For instance, CTRL/O is used to skip 
over terminal output. It skips over any output, whether sent by DCL, 
the Task Builder, an editor, or any other system function. It only 
skips output. It does nothing else. 


NOTE 
Although you must press two keys to 
enter a control character, the system 


considers a control character as a 
Single character. 


3.4.1 CTRL/C 


CTRL/C is a line terminator. Its main use is to gain the attention of 
the operating system. 
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In most cases, CTRL/C gives you access to the operating system without 
interrupting any tasks you may have running from your terminal. 


Typing a CTRL/C causes the CLI to prompt for command input with an 
explicit prompt. This prompt will be either DCL> or MCR>, depending 
on which CLI your terminal is set to. You can then type a command 
without interrupting any other tasks active at your terminal. 


This is particularly convenient when you want to abort a task running 
from your terminal. 


CTRL/C also assures you that the command you enter will go to DCL when 
the DCL> prompt is showing. 


If a terminal is receiving output from a task, CTRL/C interrupts that 
output. After DCL processes the input directed to it, the system 
resumes the interrupted output. No output is lost. 


CTRL/C has special effects in two cases: 


e If you have placed your VT52 in hold-screen mode with the 
command SET TERMINAL/HOLD SCREEN, a CTRL/C and a RETURN takes 
the terminal out of hold=-screen mode. It is easier to type a 
CTRL/C than to type SET TERMINAL/ NOHOLD SCREEN. It does not 
matter whether you type in a command in response to the DCL> 
prompt; hold-screen mode is disabled anyway. Hold-screen 
mode is available in this form on VT52s only. 


e If a CTRL/S has temporarily halted the output of data to the 
terminal, a CTRL/C starts it up again. In this case, CTRL/C 
is the same as CTRL/Q. See the discussion of CTRL/S and 
CTRL/Q in the next section. 


3.4.2 CTRL/S and CTRL/Q 


This pair of control characters is used to alternately stop and start 
output to a terminal. It is particularly useful on video terminals 
where the output may go by too fast to be read, but it works. on 
hard-copy terminals as well. 


CTRL/S delays the output and CTRL/Q resumes it. CTRL/C has the same 
effect as CTRL/Q. 


If you use these commands, you will not skip over any of the output. 
All output that should appear, will appear. It is simply held back 
until you are ready to look at it. (For skipping output, see the 
discussion of CTRL/O in the next section.) 


CTRL/S can have one unexpected effect. 


Often, as you are working your way through a file or some other output 
using these commands, you will reach the end of the output and receive 
a prompt from DCL or some other system program. Since you have been 
stopping output with a CTRL/S for some time, you may type it once 
more. Then, when you try to respond to the prompt, nothing appears on 
the terminal. This is because the CTRL/S is holding back output to 
the terminal, including the echoes of what you have just typed in to 
the prompt. A CTRL/Q causes the missing echoes to appear and the 
system response follows. 
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3.4.3 CTRL/O 


This control character is used to skip over unwanted output to your 
terminal. It is analogous to the fast-forward control on a tape 
recorder. 


If you type a single CTRL/O in response to undesired output, the 
output stops appearing on your terminal, but the system continues to 
generate the output. It can do this much faster when it does not have 
to print it on the terminal. If you type another CTRL/O, the output 
picks up at the point the operating system has reached, not the print 
at which you typed the last CTRL/O. If you do not type another 
CTRL/O, the system continues to generate the output until it reaches 
the end, whereupon a prompt appears and you may continue in response 
to the prompt. 


If you are printing muitipie files on your terminal, the CTRL/O will 
be cancelled at the end of each file. For example, if you have typed 


SEYPE S457 


the system will start with the first file of the type .LST in your 
directory. If you suppress this output with a CTRL/O, the system will 
Start printing again as soon as it reaches the beginning of the next 
file of the type .LST. 


3.4.4 CTRL/Z 


Typing CTRL/Z indicates end-of-file. It is used to indicate to system 
tasks, such as the MACRO-11 Assembler or the Task Builder, that you 
have finished and that the task should exit. 


A CTRL/Z in response to a prompt or at the end of a command line 
cancels the command. 


CTRL/Z is also used as a command within many system tasks, 
particularly the editors. 


If your terminal appears to be hanging, a CTRL/Z will often clear it. 


A CTRL/Z in response to a request for input from an indirect command 
file cancels the execution of the remainder of the file. 


Fundamentally, CTRL/Z signals the system that you have finished typing 
input. 


3.4.5 CTRL/U 


CTRL/U deletes the current line on your terminal. It is as if the 
line had never been typed. The system responds with a carriage return 
and a line feed so that the line can be retyped. 


If you use CTRL/U with a CREATE command when typing in a_ sequential 
file, the line you have deleted will appear as a blank line within the 
file. 


In three instances, a “U may appear on your terminal without your 
having typed in a CTRL/U. 
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e A system-generation option automatically sends a CTRL/U to any 
terminal that has been awaiting input past a time-out limit. 
This limit can be set by your system manager in seconds to 
anything from one second to 21 minutes. If this option is 
included, any line that is not terminated within the time-out 
limit is wiped out, as indicated by the CTRL/U that appears at 
the terminal. If you have typed in a line and then deleted it 
with the DELETE key, the system still interprets this as a 
line awaiting input and sends the CTRL/U when the time-out 
limit passes. 


@ If you try to type more than 80 characters on a line without 
using a hyphen to continue the line, the system automatically 
cancels the command and indicates this by sending a “U to the 
terminal. See Section 1.2.13 for more information on line 
continuation. . 


e Finally, if there is no available pool space when you type in 
a command, the system sends a “U to your terminal informing 
you that your command has been cancelled. In this case, the 
condition will usually be corrected shortly. Try typing the 
command again. If this does not work after some reasonable 
interval, inform your system operator of the problem. 


Ne New ae Vv his Zz a Oe Ne ne 


3.4.6 CTRL/R 


Typing CTRL/R before ending a line causes the line to be retyped as it 
currently stands, that is, with any corrections you have made in it. 


This command is most useful on hard-copy terminals, where the DELETE 
key causes characters to be retyped as they are deleted. You can also 
use it on a video terminal to confirm that a line is what you think it 
is. 


For example: 


>THIMKNAAN NK CTIRLR) 
= THINK 


You may then continue typing the line. 


Although you see two copies of the line, there is only one line as far 
as the system is concerned. 


If you are typing a command on your terminal when a broadcast or 
system message arrives, you will see a “R and a second copy of your 
command line. Simply continue typing the command. 


3.4.7 CTRL/X 


A CTRL/X clears your terminal's typeahead buffer. This buffer is used 
to store input characters temporarily until your terminal can pass 
them to the operating system. 


Occasionally, this buffer gets full. When your typeahead buffer is 
full, you cannot type on your terminal and any key you strike rings 
the bell (buzzer, beeper). When this happens, type a CTRL/X and you 
may continue using your terminal. 


See Section 3.8.1, the description of the SET TERMINAL command, for 
more information on the typeahead button. 
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HELP 


3.4.8 CTRL/L 

A CTRL/L performs a form feed. Form feeds are interpreted differently 
by different kinds of output devices. A form feed will always add 
several line feeds at the point at which it is inserted. On a line 


printer, a CTRL/L will usually move the paper past the next 
perforation. 


3.4.9 Other Control Characters 


CTRL/G inserts a bell (buzz, beep) in a file or message. CTRL/G 
cannot be the first character ina line. 


CTRL/I is the same as TAB. The cursor or print head moves to the next 
tab position. Tabs are set every eight places. 


CTRL/K inserts a vertical tab by performing four line feeds. 


CTRL/M is the same as a RETURN. 


3.5 HELP 


HELP displays information about DCL and MCR commands and may display 
other information about the operating system. 


HELP is the only command that you can issue without logging in. 


Format 


>HELP[/OUTPUT: filespec] [/qualifier] [%] [parameterl] [...parameter9] 


Command Qualifiers 


/OUTPUT: filespec 
/LOCAL 

/GROUP 
/CLI:cliname 
/MCR 

/DCL 
/FILE:filespec 
/filename 


Parameters 


No parameters are required for the HELP command and there are no 


prompts. You can get help on any given DCL command or subtopic, 
however, by typing a question mark (?) in response to the prompts 
from DCL. You can also get help by typing a question mark in 


response to the system prompt (>) and to the explicit DCL prompt 
(DCL>). Examples follow at the end of this section. 
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The HELP command without qualifiers or parameters displays th 
list of commands for the command line interpreter (CLI) for which 
your terminal is set, DCL, MCR, or some alternative CLI in use at 
your installation. This display contains information on getting 
more help. 


The displays for all forms of the HELP command are stored in help 
files, which are text files in help file format. See Section 
3.5.1 for information on writing help files. 


If you include a parameter in the HELP command, you will jump 
over the initial HELP display to a display concerning the 
parameter you have included. Examples follow at the end of this 
section. 

Usually this parameter will be a command name. When seeking hel 
on a command, you should always start with a single parameter 
The display always includes directions for getting any availabl 
further help. 


parameter9 


There can be up to nine levels of help. In any case, the number 
of parameters you enter determines the display shown; you always 
jump over intervening displays. See Section 3.5.1. 


Command Qualifiers 
/OUTPUT: filespec 


Permits you to name an output file where the requested help text 
is to be saved. The default is /OUTPUT:TI:. 


The following qualifiers are mutually exclusive. These qualifiers 
have the effect of naming a file where the requested help text is 
located. No matter which qualifier you use, you can still include up 
to nine parameters. 


If you are in DCL and use none of these qualifiers, the default 
command is HELP/DCL. If you are in MCR and use none of these 
qualifiers, the default command is HELP/MCR. 


/LOCAL 


2 


6 


Specifies that the help text is in the file HELP.HLP in the 
default directory on the default volume. You can specify a local 
help file in two ways: HELP/LOCAL or HELP %. Examples follow at 
the end of this section. 


/ GROUP 


Specifies that the help text is in the file HELP.HLP in the 
directory [current group,l] on the default volume. All users 
with the same group number have access to this file by typing 
HELP/GROUP. Examples follow at the end of this section. 
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/CLI:cliname 


Specifies that the help text begins in the file LB:[1,2]cli.HLP. 
This qualifier is for installations with alternate CLIs for which 
HELP is provided. The cliname can be from 1 through 6 Radix-50 
characters. Examples follow at the end of this section. 


/MCR 
Specifies that you wish help on an MCR- command. For this 
qualifier, the help text begins in the file LB:[1,2]MCR.HLP. 
This is the defauit for terminals set to MCR. 

7DCL 
Specifies that you wish help on a DCL command. For this 
qualifier, the help text begins in the file LB:({1,2]DCL.HLP. 
This is the default for terminals set to DCL. 

/FILE:filespec 
Specifies any file where help text is located. If you do not 
give a complete file specification, the defaults are 


LB: [1,2] filename.HLP. 


/filename 


Specifies that the help text begins with LB:[{1,2]filename.HLP. 
When using this qualifier, you cannot snecify the device, UFR, or 
extension, only the filename. 
Examples 
~HELF 


Helr is available for the following DCL commands? 


ABORT ALLOCATE AF FENT ASSIGN BACKUF 
BASIC BROADCAST CANCEL COBOL CONTINUE 
CONVERT COFY CREATE DEALLOCATE DEASSIGN 
DEBUG DELETE DIFFERENCES DIRECTORY DISMOUNT 
ELLT FIX FORTRAN HELF HOLD 
INITIALIZE INSTALL LIBRARY LINK LOGIN 
LOGOUT MACRO MCR MOUNT FRINT 
PURGE RELEASE REMOVE RENAME REQUEST 
RUN SET SHOW SORT START 
STOP TYFE UNF IX UNLOCK 

For ainformetion on 2&8 commands tyre HELF commandname. 


Additional hele on a rarticulser euelifier is often available 
by tyrant 


HELF commandname auslifier. 


You can elso get any DCL hele on DCL commands oy tyring 3 7 
im resFonse to g Promet-. 
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For informetion om utilities, sustem tasksr end other system 
informatians tyre HELF MORE, For the short forms of some 
commands» tere HELF BRIEF. For neler on lossins its tyre HELF 
LOGIN. 


This example shows the initial display from HELP. The user typed 
HELP without parameters or qualifiers at a DCL terminal. 


+TYFE 
File(s)? ? 


TYFEC/aquaelifier€s] filesrects] 
/DATE? dd-mmm-yy 
/SINCEtdd-mmm-ey 
/THROUGH i dd-nmm-ys 
SINCE t dd-mmn-ys/ THROUGH! dd-mmm—-ey 
¢TODAY 
/EXCLUDEt filesrec 


The TYFE command disrlays the contents of text files om vour 
terminal. 


Fileis)? 


This example shows the display that results from typing in a 
question mark (?) in response to a prompt from DCL. The same 
display results from typing HELP TYPE. 


>SHOW 
Funmetion? 7? 
SHOW thins 


The SHOW command can be used to show somethins. The 
followings things can be shown with this command? 


ACCOUNTING ASSIGNMENTS GROUFPFLAGS QUEUE LIBRARY 
CLOCK QUEUE SYSTEM COMMON MEMORY TASKS 
QEFAULT TERMINAL DEVICES PARTITIONS 
COAYITIME FROCESSOR USERS 


Abbreviation: §$ 
Function? PTIME 


SHOW DAYTIME 
SHOW TIME 


The SHOW TIME command disreleys the current time and date. 
The time is in 24-hour format and the date is formatted as 
dd-mmm~ oy 
Function? 


This example shows the display that results from typing a 
question mark (?) and a keyword in response to a prompt from the 
SHOW command. The same display results from typing HELP SHOW 
TIME. 
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3.5.1 Help File Format: Writing a Help File 


The HELP facility requires a specially formatted file or files called 
help files. A help file is a text file with up to nine levels of 
nesting. The format is much the same as a conventional outline. The 
file starts with a main topic followed by any subtopics. Each 
subtopic can include sub-subtopics, and so on through all nine levels. 


The format is the same for any help file: local, group, cli, or 
special purpose. 


You can put all help text in a single file, but for faster processing 
on larger help files, you will probably want to use indirect 


referencing. This is explained further below. The first (or _ only) 
help file accessed is called the root file. 


In addition to the help text, a help file includes the numbered level 
indicators, as well as other operators to indicate synonyms and 
indirect references. The operators must appear in the first column. 
Anything else that appears in the first column is ignored by HELP. 
The help operators include the level numbers from 1 through 9, the 
number sign (#) indicating a synonym, and the at sign (@) indicating 
an indirect file reference. 


The level number in the first column must be followed by at least one 
blank or tab before the parameter. The parameter must be all 
uppercase characters without intervening blanks or tabs. Any text 
that appears before the first level-number line is printed in response 
to a HELP command without any parameters. 


Parameters at each level must have different names, but nameS can be 
duplicated at each different level, as shown in the example. You need 
type only the distinguishing portion of a parameter. 


HELP interprets its command line in a strictly nested fashion. When 
interpreting parameters, HELP searches down through the help file for 
the first line starting with the numeral 1 followed by the specified 
parameter. If such a line exists, HELP displays all the text between 
that line and the next level number. The lines with level numbers and 
parameters in them are never displayed. 


If you specify more than one parameter, HELP searches for a line 
starting with the numeral 1 followed by the first parameter and then 
continues the search for a line starting with the numeral 2 followed 
by the second parameter. If HELP encounters a line starting with the 
numeral 1 before encountering the appropriate level-2 line, the search 
stops. If the line starting with a 2 followed by the parameter given 
is encountered, HELP displays the text between that line and the next 
level-number line. This same procedure is followed for all nine 
parameters. 


The level-number line is not always followed by text. The following 
line may begin with a number sign (#) or an at sign (@). If the line 
begins with a #, HELP substitutes the synonym given there for the 
original parameter and continues the search. If the following line 
begins with an @, HELP then branches to the file specified by the @ 
and continues its search in that file. 
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All these operators are included, with further commentary, in the 
following help file example: 


Here is the text displayed by typing HELP without parameters. 
Introductory information on the further use of the help file 
usually appears here. For better appearance, the first 
character in each line is usually a tab or blank, but there is 
no technical requirement that you do this. The HELP processor 
ignores any first character except the numerals 1 through 9 
and the symbols @ and #. It is good practice to limit text to 
about 20 lines so that the display text can be displayed on a 
video terminal without scrolling and with room left to enter a 
command without losing help text. Text at each level should 
refer to all help available at the next level. 


Further help is available. Type 


HELP FIRST-LEVEL1 HELP SECOND-LEVEL1 
HELP INDIRECT HELP SYNONYMS 
HELP PURPLE HELP MAUVE 


1 FIRST-LEVEL1 
This is the first level-l help text. The first line of this 
text must begin with the numeral 1. This is the text 
displayed if you type 


>HELP FIRST-LEVEL1 


The parameter must be all uppercase characters (CAPITALS). It 
is not necessary to type the full text of the parameter to 
display the text, but you must type enough of it to 
distinguish the parameter from all other parameters at the 
same level. In this example, typing 


>HELP FIRST 


would be enough. The parameter must be separated from the 
level number by one or more blanks or tabs. The parameter 
itself cannot include any blanks or tabs, but phrases can be 
tied together with hyphens or underscore characters. If you 
do this, make it clear in your reference to that level. 


Further help is available. Type 
HELP FIRST-LEVEL] FIRST-LEVEL2 
2 FIRST-LEVEL2 
This is the text displayed if you type HELP FIRST FIRST. This 
is the first level-2 help text. 
1 SECOND-LEVEL1 
This is the text displayed if you type HELP SECOND. This is 
the second level-l help text. 
Further help is available. Type 


HELP SECOND-LEVEL1 SECOND-LEVEL2 
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2 SECOND-LEVEL2 


This is the text displayed if you type HELP SECOND SECOND. 
This is the second level-2 help text. 


1 INDIRECT 


Help files can also include indirect references to other help 
text. These indirect references greatly decrease search time 
because once the HELP processor sees the indirect reference, 
the calling file (this file) is left behind. The filespec can 
be any legal filespec. The default file type is .HLP. If you 
use a file type other than .HLP, that type becomes the default 
file type for that session of HELP. 


The file referred to in this manner has the same format as 
other help files, except that if the indirect file contains 
level numbers, these must be greater than the level number in 
the calling file. For instance, if the calling file contains 
the lines 


1 INSTANCE 
@ INSTANCE 


then INSTANCE.HLP can contain only level numbers 2 through 9. 
Further help is available. See 


HELP INDIRECT EXAMPLE 


2 EXAMPLE 
@EXAMPLE.HLP 


1 SYNONYMS 


1 MAUVE 
#PORPLE 


HELP also permits cross-references between two or more similar 
or synonymous parameters. The format for synonyms appears 
below. You can greatly assist the user by trying to imagine 
what might be typed in seeking particular help text and 
including the most likely possibilities as synonyms. 


The synonyms must all precede the main entry to which they 
refer. The main entry and all synonym entries must have the 
same level number. 


1 MAGENTA 


#PURPLE 


e 


1 PURPLE 


Color of a hue between blue and red. Shades of purple include 
mauve, violet, plum, lilac, puce, amethyst, and magenta. 
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3.6 BROADCAST 
BROADCAST displays a specified message at one or more terminals. 
Format 

BROADCAST 

To? [ttnn:] 


Message? message 


BROADCAST/qualifier 
Message? message 


BROADCAST @filespec 
Command Qualifiers 


/ALL 
/LOGGED_IN 


Parameters 

message 
The message must fit on a single line, but the final character 
can go in column 80. # £=The message can include any printing 
character. Lowercase letters are converted to uppercase. 
If you do not specify a destination for the message, the message 
is sent to pseudo device CO:, the operator's console. This is 
the equivalent of the REQUEST command. See Section 3.7. 

ttnn: 
Specifies the terminal to which you wish the message to be sent. 


Terminals need not be logged in to receive messages, but they 
must be turned on (powered). 


username 


Shiga an 


-user is logged in on.” 


@filespec 


Specifies the name of an indirect command file. All users can 
send multiple messages or multiple copies of the same message 
using this method. The file should contain messages in the 
following format: 


TTnnsmessage 


Privileged users can also use the privileged qualifiers in the 
following formats: 
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The indirect command file cannot include any Indirect directives 
or labels, only destinations and messages. The destination 
cannot be preceded by tabs or blanks. 


Command Qualifiers 
/ ALL 


This privileged qualifier sends the same message to all powered 
terminals, excluding slaved terminals. 


/LOGGED_IN 


This privileged qualifier sends the same message to all logged-in 
terminals. 


Examples 


*SERODADCAST 
To? TT203 
Messedge? Meet me in the alley behind the barn. 


The message is printed on TT20: 


30-OCT-82 FROM: TT10; TO? TT203 
MEET ME IN THE ALLEY BEHINI THE BARN. 


As the message arrives, the terminal's audio signal sounds. 
Notice that the message is printed in uppercase characters on the 
receiving terminal. 


*BROADCAST TT1i23 THIS IS A ONE-LINER, 
This is the one-line form of the commana. 


> BROAICAST/LOGGED_IN 
MessadeT Evervbody teke tne rest of the day off. 


The message is printed on all logged-in terminals. This is a 
privileged command. 


“BRO @DAILY 
The file DAILY.CMD contains the following messages: 


TTLLISWHERE IS THE DITKO CONTRACT? 

TTIS?MEET ME FOR LUNCH AT 11230 

TT27;THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG 
TTSSiGET BACK TO WORK 

TT41:1T LOST MY GREEN EYESHADE. HAVE YOU SEEN IT? 


The messages are sent to the designated terminals. Privileged 


users can also inciude messages preceded by ALL: and LOGGED _IN:. 
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Notes 
B is the short form of BROADCAST. 
Only terminals can receive messages. 


If you wish your message to include lowercase characters when 
printed, enclose the message in "quotes." 


If the message cannot be broadcast within 10 seconds, the system 
displays the following message at the initiating terminal: 


BRO -- Terminal is busy --TTnn: 


If a user specifies multiple destinations, the system returns an 
error message for each busy terminal. 


The BROADCAST command uses the write-breakthrough feature of the 
terminal driver. This means the message breaks through any kind 


of I/O at the destination terminal. If you are editing, for 
instance, the message may appear in the middle of your text, but 
in fact it has no effect on the text you are editing. You can 


issue a SET TERMINAL/NOBROADCAST command if you do not wish to 
receive broadcasts. See Section 3.8.1. 


This command invokes the MCR BRO task. 


Error Messages 
BRO -- Command input error 


Explanation: The BROADCAST task did not receive the command 
ines 


User Action: Often this message results from a missing indirect 
command file. Locate the file; or, check for proper syntax and 
enter the command again. 

BRO -- Command syntax error 


Explanation: The command syntax was not correct. 


User Action: Check for proper syntax and enter the command 
again. 


BRO -- Illegal device specified 
Explanation: The destination device was not a terminal. 


User Action: Check for proper device and enter the command 
again. 


BRO -~ Privileged command 


Explanation: Nonprivileged users cannot send messages to all 
connected or logged-in terminals. 


User Action: Use an indirect command file to send messages to 
multiple terminals from a nonprivileged terminal. 
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BRO -- User not receiving messages 
BRO -- TTnn:message 


Explanation: The message was sent to ae terminal set to 
NOBROADCAST. 


User Action: Wait and try again. 


3.7 REQUEST 
REQUEST sends a message to pseudo device CO:, the operator's terminal. 
Format 


REQUEST 
Message? message 


REQUEST message 

Parameter 

message 
The message must fit on a single line, but the final character 
can go in column 80. The message can include any printing 
character. Lowercase letters are converted to uppercase. 
The message is time-stamped and indented on the operator's 
terminal. 

Example 


“REQUEST Charlies the tare drives gre down asain. 


The message appears on the operator's console in the following 


format: 

13230%45 Login user ISHMAEL 

13332345 Login user MOBYDICK 

132352347 
12-SEF-82 FROM: TTS63 TO 
CHARLIE: THE TAFE DRIVES ARE DOWN AGAIN 

13336322 Login user QUEEQUEG 

14336342 Lodin user FEQUOD 


+ 


+ 


The user at TT56: observed a problem on the system and reported 
it to the operator with REQUEST. The message appears on the 
operator's console, time-stamped and indented so that it stands 
ut from other messages. 
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The REQUEST command is very similar to the BROADCAST command. 
The main difference is that no destination is required. 


CO: is usually, but not always, TTO:. In most installations, 
however, any REQUEST message will come to the attention of the 
operator or system manager. 


See the discussion of COT, the Console Output Task, in the 
RSX-1L1M/M-PLUS System Management Guide for more information on 
CO:. 


3.8 SET AND SHOW TERMINAL 


SET TERMINAL and SHOW TERMINAL are complementary commands. SET 
TERMINAL sets terminal characteristics and SHOW TERMINAL displays 
information about terminal characteristics. For detailed information 
about these characteristics, see the discussion of the full-duplex 
terminal driver in the RSX-11M/M-PLUS I/O Drivers Reference Manual. 


3.8.1 SET TERMINAL 


SET TERMINAL sets various attributes of your terminal. Privileged 
users can set attributes for any terminal. 


Format 
SET 
Function? TERMINAL[:TTnn:] 
Terminal Attribute? attribute[/attribute[s] ] 
SET TERMINAL[:TTnn:] [/attribute] [/attribute[s] ] 


Attributes 


Group 1: Common Use 


/ {NO] LOWERCASE / [NO] UPPERCASE 

/{NO]HOLD SCREEN /MCR 

/DCL /SPEED: (transmit,receive) 
/ [NO] PRIVILEGED /CLI:cliname 

/{NO] BROADCAST /WIDTH:in 


Group 2: Terminal Setup 


/ASR33 /VTO5B 
/ASR35 /VT50 
/KSR33 /VT52 
/KSR35 /VT55 
/UA12 /VT61 
/GA30P /VT100 
/LA30S /VTLOL 
/LA34 /VT102 
/LA36 /VT105 
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/LA38 
/LA100 
/UA120 
/UA180S 


/ [NO] HARDCOPY 
/CRFILL:n 
/{NO] FORM FEED 
/PAGE LENGTH:n 
/ {NO] AUTOBAUD 
Group 3: Task Setup 
/ (NO] ECHO 

/ [NO] FULL DUPLEX 
/ [NO] INTERACTIVE 
/ [NO] LOCAL 


/ {NO] TYPEAHEAD[:n] 


/{NO] EIGHT BIT 


Command Option 


TTnn: 


/VT125 
/VT131 
/VT132 


/{NO] SCOPE 
/LEFILL 

/ [NO] TAB 
/MODEL:arg 


/{NO] ESCAPE 
/ [NO] PASSALL 
/{NO] REMOTE 
/ [NO] SLAVE 
/ (NO] WRAP 
7 {NO] SERIAL 


Specifies the terminal for which an attribute is to be set. 


For nonprivileged users, only your own terminal number or TI: is 


permitted here. 


Since TI; 


is the defanlt, nonprivileged 


ee 


need not give a terminal number. Privileged users can name any 
terminal. 

Attributes 
You can set several attributes at once. This results in several 
commands queued to MCR. If one of these commands fails, all 
others following it in the command line also fail. 

Group 1: Common Use 
The following parameters set terminal characteristics that are 
regularly needed by the average terminal user. 

/ UPPERCASE 

/NOLOWERCASE 
/UPPERCASE is the default. All characters typed on the terminal 
appear in uppercase. /NOLOWERCASE is the same as /UPPERCASE. 

/ LOWERCASE 

/NOUPPERCASE 
Characters typed on the terminal in lowercase appear in 
lowercase. It iS common practice to set terminals to lowercase 
in a LOGIN.CMD file. Most system tasks will accept input in 
lowercase. Note that some terminal escape sequences use 


lowercase characters. If, for instance, the keypad commands in 
EDT do not seem to be working, you may have to set the /LOWERCASE 
attribute, 
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/{NO] HOLD SCREEN 


/MCR 


/DCL 


Sets a VT50, VT52, or VT55 terminal to HOLD SCREEN. 


Video terminals can present output much faster than you can read 
it. HOLD SCREEN lets you accept output on your VT50, VT52, or 
VT55 terminal one line or one screenful a time. 


/NOHOLD SCREEN is the default. Output appears at the bottom of 
the screen and scrolls off the top at the rate it is sent to the 
terminal. 


/HOLD SCREEN first clears the screen, then fills in from the top 
of the screen to the bottom and stops. If you want to see 
another line, press the SCROLL key once. If you want to see 
another screenful, press the SCROLL key while holding down the 
SHIFT key. Data is being held back. It is not being lost. 


If you want to disable HOLD SCREEN, either issue SET TERMINAL/ 
NOHOLD SCREEN or press CTRL/C. 


You can also control output with the CTRL/S and CTRL/Q keys. On 
terminals in the VT100 series, you can use the NO SCROLL key. 
See Section 3.2.6 for more information. 


Sets terminal to MCR. Terminal no longer accepts DCL commands. 
The counteracting MCR command is SET /DCL=TTnn:. 


Sets terminal to DCL. Since this is a DCL command, it is mainly 
useful for privileged users who wish to set some other terminal 
to DCL, but it is not a privileged command. 


/SPEED: (transmit ,receive) 


Sets terminal's rates for transmission and reception of data. 
This software speed setting must be matched by the hardware speed 
setting, which is controlled by switches on the terminal itself. 
The first mumber in parentheses is the transmission rate, the 
second is the reception rate. Note the use of the comma. When 
you issue SHOW TERMINAL/SPEED, the output has a colon separating 
the two rates, but when you issue SET TERMINAL/SPEED, you must 
separate the two rates with a comma. See the examples. 


Rates are expressed in baud, or bits per second. A rate of 110 
baud is the equivalent of 10 characters per second. For baud 
rates above 110, the rate divided by 10 is the equivalent in 
characters per second. Thus, 300 baud, the usual LA36 rate, is 
equivalent to 30 characters per second, and 9600 baud, the usual 
video terminal rate, is equivalent to 960 characters per second. 


In any case, you are limited to the hardware speed settings for 
your terminal. See the documentation provided with your 
terminal, or your system manager, for further information. 
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/ {NO] PRIVILEGED 


Sets a terminal privileged or nonprivileged. A privileged 
terminal can issue all DCL and MCR commands. The default is 
determined by whether you log in privileged or nonprivileged. 
Privileged users are those whose UIC has a group number equal to 
or lower than 10. (The group number is the first number of the 
UIC.3 Setting this attribute is a privileged option. 


/CLI:cliname 


Sets a terminal to an alternate command line interpreter (CLI). 
The cliname is from one to six Radix-50 characters. See your 
system manager for information on any alternative CLIS at your 
installation. 


/ [NO] BROADCAST 


Establishes whether you wish to receive broadcast messages on 
your terminal. The default is to receive broadcasts. 


This attribute restricts messages from BROADCAST and SHUTUP only. 
All BROADCAST messages are intercepted when you set your terminal 
/NOBROADCAST. Senders are notified that you are not receiving 
messages. See the examples. As for SHUTUP, all messages about 
the pending shutdown of the system are intercepted except those 
issued in the last five minutes of SHUTUP. These are the only 
messages intercepted when you set your terminal /NOBROADCAST. 


Fant nt 


Se eee oe ae ee <- = 


Messages [rom other tasks are 
/WIDTH:n 


The SET TERMINAL/WIDTH command sets the width of your terminal, 
that is, the length of a line. n can be from 0 through 132. 
Note that a line length of zero means no commands can be entered 
on the terminal. 


Group 2: Terminal Setup 


The following qualifiers set hardware characteristics of 
terminals. For certain common models, you can set a number of 
characteristics automatically simply by identifying the model. 
For other terminals, you must set these characteristics 
explicitly, or alter the terminal driver to recognize them. 


Here are the models for which automatic setup is provided: 


ASR33 ASR35 KSR33 
KSR35 LA1l2 LA30P 
LA30S LA34 LA36 
LA38 LA100 LA120 
LA180S VTO5B VT50 
VT52 VT55 VT6l 
VT100 VT1O1 VT102 
VT105 VT125 VT131 
VT132 
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Most of these are DIGITAL terminals. Those with "LA" 
designations . are hard-copy terminals; those with “vtT" 
designations are video models. Those with "SR" follow the 


Teletypel pattern. 


Setting a terminal to a particular model does not mean that the 
terminal will behave like that model. it means only that the 
operating system will treat the terminal as if it were that 
model. This feature is intended primarily to deceive tasks that 
expect a certain terminal model or to identify a terminal as_ to 
what it is. 


You can set hard-copy terminals as video terminals and you can 
set video terminals as hard-copy terminals. For the terminal 
user, the most noticeable difference will be in the way the 
DELETE key operates. Setting terminals from hard-copy to video 
may prove disruptive; setting terminals from video to hard-copy 


is less likely tc cause trouble. 


Setting a terminal to a particular model designation 
automatically sets a number of attributes for the terminal. See 
the RSX-11M/M-PLUS I/O Drivers Reference Manual for complete 
information on the settings for each terminal model. 


You can also set these attributes individually. Nonprivileged 
users can set them for their own terminals; privileged users can 
set them for any terminal. 


The defaults for these attributes depend on how your terminal is 
known to the system when you log in. You can find out how your 
terminal is known to the system by logging in and issuing a SHOW 
TERMINAL command. 


/ NOHARDCOPY 
/SCOPE 


Sets terminal as a video terminal. /SCOPE is the equivalent of 
/NOHARDCOPY. 


/ HARDCOPY 
/NOSCOPE 


Sets terminal as a hard-copy terminal. /NOSCOPE is the 
equivalent of /HARDCOPY. 


/ {NO] AUTOBAUD 
The /AUTOBAUD qualifier enables autobaud detection on a remote 
dial-up line. This means that when a remote terminal dials up, 
the terminal driver samples the first character sent along the 


line to determine the incoming baud rate and sets the interface 
speed accordingly. The default is /NOAUTOBAUD. 


1. Teletype is a trademark of the Teletype Corporation. 
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/CRFILL:n 


Sets the attribute used to accommodate the 
carriage-return/line-feed process on hard-copy terminals. While 
the terminal is performing the line feed, a number of null 
characters may be needed to fill in for the time the terminal is 
not capable of accepting new characters. The value n can be any 
number from 0 through 7. 


/UFFILL 


Sets the attribute used to accommodate vertical spacing on 
terminals. While the terminal is performing a vertical tab, line 
feed, or form feed, four null characters are sent to fill in for 
the time the terminal is not capable of accepting new characters. 


/ [NO] FORMFEED 


If the terminal hardware supports form feeds, the terminal should 
be set /FORMFEED. If form feeds are handled by the software 
providing line feeds, the terminal should be set /NOFORMFEED. 


/ [NO] TAB 


If the terminal hardware supports horizontal tabs, the terminal 
should be set TAB. If tabs are handled by the software providing 
Spaces, the terminal should be set NOTAB. 


/PAGE LENGTH:n 


Defines the number of lines to a page. By convention, a page is 
usually considered the number of lines to a screenful on video 
terminals or the number of lines between perforations on 
hard-copy terminals. This attribute sets the length of the page. 
(Width is set through the SET DEVICE command, Section 5.10.2.) 


/MODELin 


This parameter is used primarily to identify terminals that are 
not on the automatic setup list. Your system manager will tell 
you if you need to use this parameter. 


SYSTEM MANAGERS 


n can be any decimal number from 0 through 255 (0-377 
octal). The first half of these numbers (0-127 decimal 
or 0-177 octal) is reserved for use by DIGITAL. Each of 
the terminals on the automatic setup list is assigned one 
of these numbers. The second half (128-255 decimal or 
200-377 octal) is available for other terminals. 


Setting a terminal with an /MODEL value has little effect by 
itself. If the /MODEL value is that of one of the terminals on 
the automatic setup list, the effect will be the same as’ setting 
the terminal to that model. If the /MODEL value is unused, then 
setting the terminal to that value affects nothing but the output 
from SHOW TERMINAL/MODEL. 
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If you wish automatic setup for those terminals not included in the 
automatic setup list, you can add /MODEL values to the table in 
SY0:[{11,10]TTDAT.MAC and then reassemble and relink the terminal 
driver with the new table. Procedures for adding entries to the table 
are given in the comments in TTDAT.MAC. 


If you do this, a SET TERMINAL/MODEL command with the proper 
value will set up such a terminal automatically. You cannot 
identify such terminals by a name; only a /MODEL value is 
permitted. 


Group 3: Task Setup 


The following parameters set terminal characteristics that may be 
needed by system or user tasks. Most system tasks that require 
these attributes in a terminal will set the attributes when they 
attach the terminal. User tasks can also do this. This will be 
transparent to the user. These parameters are included for use 
in cases where the task does not do this setting. See the 
RSX-11M/M-PLUS I/O Drivers Reference Manual for information on 


how tasks can set terminal attributes. 


/ [NO] ECHO 


Enables (or disables) echoing of characters typed on the 
terminal. 


/ECHO is the default. Characters typed on the terminal are 
echoed on the terminal. 


/NOECHO suppresses the echo. (The system task LOGIN uses’ this 
feature to keep passwords secret.) 


/NOECHO changes nothing but echoing. Commands can still be 
passed to the system, but the system passes no echo back. 


/ [NO] ESCAPE 


Enables (or disables) recognition of escape sequences from a 
terminal. 


/NOESCAPE is the default. When you press the ESC (SEL, ALTMODE) 
key, it is interpreted as a line terminator (with a line feed but 
no carriage return). 


ESCAPE enables the recognition of escape sequences from _ the 
terminal. When you press the ESC (SEL, ALTMODE) key, it is 
interpreted as the beginning of an escape sequence. The ESC key 
will no longer terminate a line. 


This is a rarely used parameter. Most tasks that recognize 
escape sequences will attach the terminal so that escape 
sequences are passed without the user's knowledge, usually from 
the keypad. 
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/{NO] FULL DUPLEX 
Enables (or disables) full-duplex mode at a terminal. 


/NOFULL DUPLEX is the default. The terminal cannot accept input 
and receive output at the same time. "Half-duplex" is the usual 
industry term for this attribute. 


/FULL DUPLEX allows the terminal to accept input and receive 
output at the same time. This attribute is useful where echoing 
is not required, with split-screen applications, and when the 
terminal is communicating with some fulli-duplex device. 


/NOPASSALL 
/ INTERACTIVE 


Specifies that any characters typed on the terminal should be 
interpreted by the terminal driver before they are sent to a 
task. CTRL/A is accepted as a command to an interactive 
terminal. NOPASSALL is the same as INTERACTIVE. This is the 
default setting. 


/PASSALL 
/NOINTERACTIVE 


Specifies that characters sent by the terminal should not be 
interpreted by the terminal driver. Therefore, the task must 
interpret all characters. CTRL/A may be a command to a task, in 


this case; but will not affect the operating system. This 
parameter automatically sets the terminal to the /EIGHT BIT 
attribute. 

/NOREMOTE 

/ LOCAL 


Specifies that the terminal is not attached to a dial-up line. 
/NOREMOTE is the same as LOCAL. This is the default setting. 


/ REMOTE 

/NOLOCAL 
Identifies a terminal number with a dial-up line. A user can 
call in and attach a remote terminal. /REMOTE is the same as 
/NOLOCAL. 


This keyword has nothing to do with the LOCAL/REMOTE switch found 
on some terminals, which sets the terminal as a typewriter 
(LOCAL) or terminal (REMOTE), nor does it have anything to do 
with DECnet host terminals. 


/{NO] SERIAL 


This qualifier is for RSX-11M-PLUS systems only. The default is 
/NOSERIAL. When you enter a command before the, previous command 
has completed execution, -the second command. is. processed» in 
parallel with the first. _ mete 


information on ROW. to: change: the: ‘size of: the terminal's typeahe q 
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Setting. the terminal /SERIAL “means ‘that: ~the~ first: command 
completes. éxecution «before the second is passed. to the system. 
When. a terminal is set /SERIAL, ‘commands... are...retained: in. the 
terminal's typeahead buffer until itis’ time for them to be 
passed to the ‘system. See “the ‘discussion. of  /TYPEAHEAD. for. 


buffer. 


/ [NO] SLAVE 


the terminal! s PS 


‘cannot be changed -O1 


‘type are no longer ec 
-each time “you press 


Enables (or disables) slave status at a terminal. 


/NOSLAVE is the default. The terminal can both send unsolicited 
input and receive system output. The user has full access to all 
facilities of the terminal. 


This is a rarely used parameter. Most tasks that need a_e slave 
terminal will attach the terminal without specific action by the 
user. 


This parameter is not privileged, but if you set your terminal 


/SLAVE, you will need to go to a privileged terminal to set the 
terminal back to /NOSLAVE. 


This qualifier has different effects on RSX-11M and RSX-11M-PLUS. 


Cae 


Lifier ‘enables or disables 
Utena? is the: default. 
ae “send its< While 
“stored in the: terminal's 
Heres: PRLS = buffer size 
erical argument is: accepted. 
inal. ‘longer — -aecepts 
Pas ee characters you 
ane “the b 11 (buzzer, beeper) © ‘sounds 
ta eage “You can clear the typeahead buffer 
witha SCTRE/X so -/NOTY PEAHEAD- disables this feature. “The : terminal 
driver. cannot store characters: and. excess” characters are: lost. 


On RSX- LIM systems, 
waibing: “to. Ge: “se 
typeahead buffer; w 


TES the buffer ge 
unsolicited Inputs 


On RSX=11M-PLUS systems, the “/PYPEAHEAD qualifier ‘enables or 


disables” the terminal's typeahead attribute: and also sets: the 


size of the typeahead buffer. /TYPEAHEAD:86 is the default. The 
terminal accepts. input faster than it can send it. While waiting 
to be sent, this input is stored in the typeahead buffer. “If the’ 
buffer. .gets:. full, the (terminal no. longer accepts: unsolicited 
input. When the buffer is full, the characters you type are no 
longer echoed, and the bell. (buzzer; beeper) sounds each time you 
press a key. You. can clear the typeahead buffer with .a CTRL/X. 
/NOTYPEAHEAD’ disables this feature. The terminal driver cannot 
store characters and excess characters are. lost. 


On RSX=-11M-PLUS systems, you. can set. the size of the typeahead 
buffer from 0 through 255. If your terminal is: set /SERIAL, you 
may wish to increase the size of. a typeahead buffer so you can 
queue more. commands. . 
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/ [NO] WRAP 


Specifies that the terminal automatically wrap (or not wrap) 
lines longer than its line width. 


/WRAP is the default. The terminal automatically issues a 

carriage return and a line feed when you type to whatever line 

width the terminal is set for. 

/NOWRAP overrides this feature and permits unlimited line length. 
/{NO] EIGHT BIT 

Enables (or disables) a terminal's /EIGHT BIT attribute. 


/NOEIGHT BIT is the default. DIGITAL software employs 7-bit 
ASCII (without parity checking). 


/EIGHT BIT allows the terminal to pass all eight bits of the 
ASCII character. This attribute is used when your terminal is 
communicating with some device that sends 8-bit ASCII. 


Examples 
=SET 
Function? TERMINAL 
Attribute? LOWER 


This example sets the /LOWERCASE attribute for the issuing 


terminal. Lowercase characters sent from the terminal will not 
be converted to uppercase. Most system tasks will accept 
commands in lowercase. The EDT keypad commands will not work 


unless your terminal is set /LOWERCASE. 


“SET TERMINAL/LOWER 


This example is equivalent to the previous: one. This command is 
frequently included in a LOGIN.CMD file. 


“SET TERMINAL/YTS2 


This example sets the issuing terminal as a VT52. The operating 


system "sees" the terminal as a VT52. If it is in fact a 
hard-copy terminal, output to the terminal may be garbled and the 
terminal may seem to jam. This command sets a number of 


defaults. These are shown in Table 3-2. 


*SET TERM/LASS 


This example sets the issuing terminal as an LA36. The operating 
system "sees" the terminal as an LA36. If it is in fact a video 
terminal, the only noticeable side effect will be the reprinting 
of characters deleted by the DELETE key. This command sets a 
number of defaults. These are shown in Table 3-2. 


Note 


3.8.2 
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»SET TERM/SPEEDI (1107300) 


This example sets the issuing terminal to transmit at 110 baud 
and receive at 300 baud. The acceptable values for transmit and 
receive rates are inherent in the design of the terminal and 
other hardware. See the documentation provided with your 
terminal. After issuing this command, the user must reset the 
hardware to the same transmit and receive rates. You must issue 
the SET TERMINAL command first and then set the hardware so that 
the terminal driver can communicate with the terminal. 


~ 


io 
*SET TERNINAL/LAS6/SFEEDS (3001300) /NOBROADCAST 


This example sets the issuing terminal as an LA36, sets its speed 
to 300 baud for both transmit and receive, and inhibits 
broadcasting to the terminal. 


“SET TERMINAL/SERIAL/TYPEAHEADE 156 
*MACRO/SHOWSALL PETE JOHN» ROGER: KEITH QE 
LINK/TASKiWHO KEITH (ED) 

RUN WHO 


In this example, the User set his terminal /SERIAL and increased 
the size of the typeahead buffer. The user then entered a MACRO 
command, followed by a LINK command and a RUN command. The 
commands are separated by RETURNs. The LINK command cannot 
execute until the assembly completes, and the RUN command cannot 
execute until the task build completes. In fact, the LINK 
command is not even echoed until the MACRO command completes. and 
the same is true for the RUN command. The unexecuted commands 
are stored in the typeahead buffer. | 


You can find how all attributes are set for your terminal with an 
unadorned SHOW TERMINAL command. See Section 3.8.2. 


SHOW TERMINAL. 


SHOW TERMINAL displays information about your terminal and the other 
terminals on your system. 


Format 


SHOW 
Function? TERMINAL[:TTnn:] 


SHOW TERMINAL[:TTnn:] [/attribute] [/fattribute[s] ] 


Attributes 
/ {NO] LOWERCASE / [NO] UPPERCASE 
/[(NO]HOLD SCREEN 7DCL 
MCE = /SPEED 
/ [NO] PRIVILEGED / [NO] BROADCAST 
/LOGGED_ ON /CLI:cliname 
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/ [NO] ASR33 
/ [NO] ASR35 
/ [NO] KSR33 
/ [NO] KSR35 
/ [NO] LA12 
/ [NO] LA30P 
/ [NO] LA30S 
/{NO]LA34 
/ [NO] LA36 
/ [NO] LA38 
/ {NO]LA100 
/{NO]LA1L20 
/{NO]LA180S 
/(NO] VTO5B 


/ [NO] HARDCOPY 
/CREILL 

/{NO] FORM FEED 
/PAGE_ LENGTH 


/ {NO] ECHO 
/{NO]FULL DUPLEX 
/{NO] INTERACTIVE 
/ {NO] LOCAL 

/{NO] TYPEAHEAD 
/{NO] EIGHT BIT 
/HT 7 

/TT 


Command Option 


TTnn: 


Identifies the 


information. 


terminal 
The default is TI:. 


/{NO])VTSO 
/(NO]VT52 
/ {NO} VT55 
/(NOJVT61 
/ (NO) VT100 
/ [NO] VT1OL 
/(NO]VT102 
/({NO]VT105 
/{NO)VT125 
/{NO] VT131 
/ &NO) VT132 


/{NO] SCOPE 
/LEFILL 
/{NO] TAB 
/MODEL 


/(NO] ESCAPE 
/{NO] PASSALL 
/{NO] REMOTE 

/ [NO] SLAVE 

/ [NO] WRAP 

/ [NO] AUTOBAUD 


Nt 
/TI: 


about 


which you wish to display 


An unadorned SHOW TERMINAL command, such as the following: 


>SHOW 


or 


> SHOW 


TERMINAL 


TERMINAL: TT56: 


displays all the attributes set for your terminal or the terminal 


you name. 


See the examples. 


SHOW TERMINAL/ALL displays information about all terminals:‘on the 


system. 


Attributes 


Each SHOW TERMINAL 


Mop a TA AT 
LOACILNAL 


attribute 
QALLCLANULE. 


in its place under SET TERMINAL in 


attribute 


~AaS 


mh A . 
Liiv itwcailia 


is directly related to aé_ SET 
m~ ALE An ek mabe shisha 22 discussed 
May Vb SCALE ALELANULOE 15 UsowuUsvseu 

Section 3.7.1. In addition, 
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each SHOW TERMINAL attribute can have a NO in front of it to 
allow you to determine which terminals do not have a particular 
attribute. 


You can include more than one attribute in your SHOW TERMINAL 
command. This is the equivalent of entering a series of SHOW 
TERMINAL commands. That is, the command 

SHOW TERMINAL/LAS6/0ICL 


displays a list of all LA36s on your system and a list of all 
terminals set to DCL, but NOT a list of all LA36s set to DCL. 


The displays returned by SHOW TERMINAL do not necessarily match 
the attribute names used in DCL. For instance, the command 


“SHOW TERMINAL /HARDCOPY 


causes a display labeled NOCRT, meaning that the terminal is not 
a cathode-ray terminal. 


The same display results from 
“SHOW TERMINAL /NOSCOFE 
Table 3-2 shows the relationships between SHOW TERMINAL and its 


displays, and SET TERMINAL. For further information on the 
displays, see the examples. 


/HT 

TES 

fTT 

{NT 
These qualifiers display information about particular types of 
terminals on the system. /HT displays a list of DECnet host 
terminals. /TI: is the same as SHOW TERMINAL without any 
qualifier. /TT displays a list of real terminals on the system. 
/VT. displays.a list: of virtual terminals on an RSX-11M-PLUS: 
i system. hein ages igs ston aignty 1 FR at Af peed CHIE aaa cee age ae f aS apa vie 5 igs e lect sik = * 

If your SHOW TERMINAL command produces only a prompt and no output, 


there are no terminals on the system that match the attribute given in 
your command. 


Table 3-2 
Display of Terminal Attributes from SHOW TERMINAL 


SHOW TERMINAL SHOW TERMINAL SET TERMINAL 
Attribute Display Attribute 

AUTOBAUD ABAUD= AUTOBAUD 

DCL DCL= DCL 


(continued on next page) 
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Table 3-2 (Cont.) 
Display of Terminal Attributes from SHOW TERMINAL 


SHOW TERMINAL SHOW TERMINAL SET TERMINAL 
Attribute Display Attribute 
ECHO ECHO= ECHO 
EIGHT BIT EBC= EIGHT BIT 
ESCAPE ESCSEQ= ESCAPE 
FORM FEED FORMFEED= FORM_FEED 
FULL DUPLEX FDX= FULL DUPLEX 
HARDCOPY NOCRT= HARDCOPY 
NOSCOPE 
CREILL HFILL= CRFILL 
HOLD SCREEN HOLD= HOLD SCREEN 
INTERACTIVE NORPA= INTERACTIVE 
NOPASSALL 
LOCAL NOREMOTE= LOCAL 
NORBEMOTE 
LOWERCASE LOWER= LOWERCASE 
NOECHO NOECHO= NOECHO 
NOEIGHT BIT NOEBC= NOEIGHT BIT 
NOESCAPE NOESCSEQ= NOESCAPE 
NOFORM FEED NOFORMFEED= NOFORM FEED 
NOFULL DUPLEX NOFDX= NOFULL DUPLEX 
NOHARDCOPY CRT= NOHARDCOPY 
SCOPE 
NOHOLD SCREEN NOHOLD= NOHOLD SCREEN 
NOINTERACTIVE RPA= NOINTERACTIVE 
PASSALL 
NOLOCAL REMOTE= NOLOCAL 
REMOTE 


(continued on next page) 
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Table 3-2 (Cont.) 
Display of Terminal Attributes from SHOW TERMINAL 


SHOW TERMINAL SHOW TERMINAL SET TERMINAL 


Attribute Display Attribute 
NOLOWERCASE NOLOWER= UPPERCASE 
NOPASSALL NORPA= NOPASSALL 

INTERACTIVE 
NOPRIVILEGE NOPRIV= NOPRIVILEGE 
NOREMOTE NOREMOTE= NOREMOTE 
LOCAL 
NOSCOPE NOCRT= NOSCOPE 
HARDCOPY 
NOSLAVE NOSLAVE= NOSLAVE 
NOTAB NOHHT= NOTAB 
NOTYPEAHEAD NOTY PEAHEAD= NOTY PEAHEAD 
NOUPPERCASE LOWER= LOWERCASE 
NOWRAP NOWRAP= NOWRAP 
MCR MCR= MCR 
MODEL TERM= MODEL 
PAGE LENGTH LINES= PAGE LENGTH 
PASSALL RPA= PASSALL 
INTERACTIVE 
PRIVILEGE PRIV= PRIVILEGE 
REMOTE REMOTE= REMOTE 
NOLOCAL 
SCOPE CRT= SCOPE 
NOHARDCOPY 
SLAVE SLAVE= SLAVE 
SPEED SPEED= SPEED 
TAB HHT= TAB 
TY PEAHEAD TY PEAHEAD= TY PEAHEAD 
UPPERCASE NOLOWER= UPPERCASE 


(continued on 
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Table 3-2 (Cont.) 
Display of Terminal Attributes from SHOW TERMINAL 


SHOW TERMINAL SHOW TERMINAL SET TERMINAL 
Attribute Display Attribute 

LFFILL VFILL= LFFILL 

WRAP WRAP= WRAP 


Examples 


2SHOW 
Funetion? TERMINAL 


TT1s3 C203212] C303712] 
CLI = TCL BUF = 132, HFILL = 0 SFEED=(3007300) 
LINES = 66. . TERM = LA34 OWNER = SELF BRO NOARAUD 
LOWER NOFRIVY NOHOLD WNOSLAVE NOESC NOCRT NOHFF NOREMOTE 
ECHO NOVFILL NOHHT NOFIX WRAF NORFA NOERC TYPEAHEAD 


This example displays all the attributes for the user's. own 
terminal. The command is the equivalent of SHOW TERMINAL:TI:. 
These include the terminal number, the login UIC, the default 
UFD, plus all the attributes that can be set with SET TERMINAL. 
See Table 3-2 and the remaining examples. 


“SHOW TERMINALS TTS6% 


TTS46$ £72106) C303°5)] 
CLI = DCL BUF = 80, HFILL = 0 SFEED= (960079600) 
LINES = 24. TERM = VT100 OWNER = SELF BRO NOARAUL 
LOWER FRIV NOHOLD NOSLAVE NOESC CRT NOHFF NOREMOTE 
ECHO NOVFILL NOHHT NOF IX WRAP NORFA NOERC TYFEAHEADL 


This example displays all the attributes for another terminal. 
SSHO TERM/ESCAFE 


This example shows that no terminal on the system is currently 
set to handle escape sequences. 


*“SHOW TERMINAL/LASé/DCL 
LCL=TTS: 

LAZé=COO0t 

LASS=TTO} 

LAS&=TT343 


example displays all the terminals on the system set as 


is 
36s and all terminals on the system set to DCL. Note that the 
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order of the display is not necessarily the same as the order the 
attributes were listed in. Note also that the effect is the same 
as a SHOW TERMINAL/LA36 followed by a SHOW TERMINAL/DCL. In 
other words, the display does not show all LA36s set to DCL. 


>SHO TERM/LOWERCASE 
LOWER=TT1¢ 
LOWER=TT3? 


¢ 


*SHO TERM/NOUPPERCASE 
LOWER=TT1: 


? 


*SHO TERM/NOLOWERCASE 
NOLOWER=TT2? 
NOLOWER=TTS: 


+ 


*SHO TERH/UFPERCASE 
NOLOWER=TT23 


¢ 


“SHO TERM/HOLDSCREEN 
HOLD=TT2L¢ 


+ 


* 


“SHO TERM/NOHOLDU_SCREEN 
NOHOLD=TT1i: 
NOHOLD=TT 23 


+ 


“SHO TERM/MCR 
MCR=TT143 


ry 
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*SHO TERM/DICL 
DCL=TT20;3 


+ 


*SHO TERM/FRIVILEGED 
PRIV=TT73 


+ 


® 


*SHO TERM/NOPRIVILEGED 
NOPRIVETTIO‘“ 


* 


>SHO TERM/SPEED 
SFEELV=TT1029600: 9600 


This example displays the speed settings for the terminal from 
which the command was issued. 


Note that the transmission and reception rates are separated by 


i : 1 TWh, = “4 7mm FRA AR ern eae 
colon in this display. When you are setting 


a 
Ver aaay Lnese LaGeoce sy = 
figures are separated by a comma and enclosed in parentheses. 


aa 


~SHO TERM/ASRSS 
BSRSS=TT22: 


This example displays all the terminals on the system that are 
set to type ASR33. All the SHOW TERMINAL keywords naming 
specific models give the same kind of display. 


If you use the NO option, the display lists NOASR33=TTn:. 


“SHO TERM/HARDICOFY 
NOCRT=TT173 


> 


»GHO TERM/NOHARDCOPY 
CRT=TT2L% 


> 
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*SHO TERM/SCOPE 
CRT=TT213 


+ 


>SHO TERM/NOSCOFE 
NOCRT=TT173 


CRT means cathode ray tube, another name for a video screen or 
scope. 


*SHO TERM/CRFILL 
HFILL=TT10:6 


~ 
Q 
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1 + Hh 
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w 


as issued. 


i) 
~ 
y 


This exa 
which it 
»~SHO TERM/LFFILL 
VFILL=TT4233 


+ 


+ 


This example shows which terminal has its /LFFILL attribute 
enabled. 


>SHO TERM/FORMFEED 
FORMFEED=TT1i3: 


@ 
+ 


+ 


“SHO TERM/NOFORMFEED 
NOFORMFEED=TT1iS: 


This example shows which terminals have their FORMFEED attribute 
enabled (or not). 


»SHO TERM/TAB 
HHT=TT12% 


+ 


“SHO TERM/NOTAB 
NOHHT=TT?7¢ 


This example shows which terminals have their TAB attribute 
enabled. HHT means Horizontal Hardware Tabs. 
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+SHO TERM/PAGE_LENGTH 
LINES=TT7324 
This example displays the page size (screen size) of the terminal 


from which the command was issued. A nonprivileged user cannot 
display the page size of another terminal with this command. Use 


the unadorned SHOW TERMINAL. 


»SHO TERM/ECHO 
ECHO=TT1? 


+ 
+ 


¢ 


>SHO TERM/NOECHO 
NOECHO=TT1S: 


*SHO TERM/ESCAPFE 
ESCSEQ=TT11?% 


*SHO TERM/NOESCAPE 
NOESCSEQ=TT1? 


+ 


ESCSEQ means ESCape SEQuences. 


»SHO TERM/FULL_DUPLEX 
FUX=TT23 


7>SHO TERM/NOFULL DUPLEX 
NOFDUX=TT1! 


* 


FDX means full-duplex. 


»SHO TERM/FASSALL 
RFA=TT1i 


+ 


»SHO TERM/INTERACTIVE 
NORPA=TT33 


+ 
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“SHO TERM/NOFPASSALL 
NORPA=TT3?! 


+ 


~SHO TERM/NOINTERACTIVE 
RFA=TT1¢ 


+ 


RPA means Read-Pass-All. 


>SHO TERM/REMOTE 
REMOTE=TT1: 


“SHO TERM/LOCAL 
NOREMOTE=TT1i2: 


+ 


“SHO TERM/NOLOCAL 
REMOTE=TT1: 


“SHO TERM/NOREMOTE 
NOREMOTE=TT12: 


of 


This attribute has nothing to do with the LOCAL/REMOTE switch 
found on some terminals. Remote terminals access the system 
through dial-up lines while local terminals are hard-wired to the 
computer. This attribute has nothing to do with DECnet host 
terminals either. 


The LOCAL/REMOTE switch on a terminal sets a terminal as a 
typewriter or terminal, respectively. 


“SHO TERM/NOSLAVE 
NOSLAVE=TT1: 


4 
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“SHO TERM/TYPEAHEAD 
TYPEAHEAD=TT1: 


+ 


*SHO TERM/NOTYFEAHEAD 
NOTYFEAHEAD=TT27 3 


=SHO TERM/NOWRAF 
NOWRAP=TT45% 


“SHO TERM/NOEIGHT_EBIT 
NOERC=TT1: 


* 


“SHO TERM/EIGHT_BIT 
EBC=TTé? 


EBC means Eight-Bit Characters. DIGITAL software 
ACSII. 


uses 


7-bit 


CHAPTER 4 


HANDLING FILES 


4.1 FILES ON RSX-11M/M-PLUS SYSTEMS 


The commands in this chapter are used to create files, list them in 
directories, remove them from directories, print copies of them on 
your terminal or the line printer, and alter their contents in various 
ways. Some error messages from commands described in this chapter are 
documented in Appendix A of this manual. Other error messages are 
documented in the RMS documentation supplied with your system. 


All files are stored on volumes. These volumes are written on 
magnetic media, which can be placed on various physical devices. Once 
the volume is mounted, you can access the files on the volume. For 


more information about volumes and devices, see Chapter 5. 


Within each volume, files are organized in directories. For the 
entire volume, there is a Master File Directory (MFD). The MFD is a 
file named [0,0]000000.DIR. Files in the MFD are all User File 
Directories (UFDs). The UFD files are named after the group and 
member numbers. Thus, UFD [200,1] is a file listed in the MFD and 
named [0,0]200001.DIR. 


See Figure 4-1 for an illustration of the relationship between volume, 
MFD, and UFD. 


H!IYA.MAC;1 FLY.TXT;1 IZZY.TXT;1 OZY.TXT;1 LOGIN.CMD;1 


ZK-289-81 


Figure 4-1 File Organization on a Volume 
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4.1.1 File Ownership and Location 


When you log in to the system, you identify yourself with a User 
Identification Code (UIC). You log in to your default device and UFD. 
The default UFD has the same group and member number as your UIC. 
Nonprivileged users can change their default UFD, but not their UIC. 
Privileged users can change both. The UIC identifies the user; the 
UFD identifies the directory where files are located. 


The default device is actually a volume mounted on a device. Most 
file-handling commands are directed to the volume and not the device, 
but both volume and device are identified in the same format, ddnn:, 
where dd is a 2-letter mnemonic for the device type and nn is the 
octal unit number of the device. The colon is a required terminator. 
Usually, the command description or function makes clear whether the 
command is directed to the physical device or to the volume. 


Regardless of its physical designation, your default device is always 
called SyY0:. This is a logical assignment made each time you log in. 
Information on your default device is kept by ACNT, the Account File 
Maintenance Program (Sections 3.1.1 and 3.1.3), and read from there 
each time you log in. 


When you create a file, the system places the file name in a UFD along 
with a User Identification Code (UIC), indicating the ownership of the 
file. Both the UFD and the UIC have the same format, a l- to 3-digit 
octal group number and a l- to 3-digit octal member number separated 
by a comma and enclosed in brackets. These numbers range from 0 
through 377 octal. 


Directory entries in both MFDs and UFDs consist of the names of files 
and pointers to file headers. The file header holds information about 
the file's owner and the location of the file on the mass-storage 
medium. Thus, a full file specification not only identifies the file, 
but locates it as well. 


4.1.2 File Specification 


File specifications, often called filespecs, are required for many DCL 
commands. 


The format of a file specification is as follows: 
ddnn: [g,m]name.typ;ver 
ddnn: 


Specifies the type of device and unit number on which the volume 
containing the file is mounted. It consists of a 2-letter device 
name followed by an optional 1- or 2-digit octal unit number 
terminated with a colon. 


The 2-letter names for devices found on RSX-11M/M-PLUS are listed 
in Section 5.1. 


{g,m] 


Specifies the UFD. g and m are octal numbers from 1 through 377. 
g is the number of your group and m is your member number. You 
usually have full access to the UFDs with the same group number 
as yours. 
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name 


Specifies the name of the file, an alphanumeric string from zero 
through nine characters long. 


etyp 


Specifies the file type. This field is a O- through 
3-alphanumeric-character string that usually indicates the file 
contents. For example, .FTN is the file type for FORTRAN source 
programs. 


Always separate the name from the file type with a period (.). 


There are no restrictions on file types, but many system tasks 
use default file types for input and output files. These 
defaults and some system conventions on file types are summarized 
in Section 4.1.3. Null file types (0 length) are acceptable. 


sver 


Specifies the version number, normally an octal number from 1 
through 77777. The version number identifies different versions 
of the same file. When you create a file without specifying a 
version number, the system assigns the file version number 1. 
Each time you create a new version of the file, by editing it, 
for instance, the system adds one to the version number. 


You must separate the file type and version number with a 
semicolon. 


You can also create a file with an explicit version number. 


If you create a file with version number 77777, you can be sure 
that file cannot be inadvertently superseded by a file with a 
higher number; 77777 is the highest possible version number. 
This is useful where you must have a particular version of a file 
for some operation. 


In addition, you can name version 0 or version -1l in commands. 
Version 0 defaults to the most recent version of the named file; 
version -1 defaults to the oldest version of the named file. 


In most cases, RSX-11M/M-PLUS systems do not require you to enter’ the 
full file specification. Defaults are supplied for all fields of the 
file specification except the name (see Section 4.1.3). In addition, 
you can use wildcards to specify groups of related files (see Section 
4.1.4). 


4.1.3 Defaults in File Specifications 


Except for the file name, if you omit a field of the file 
specification, the system automatically supplies the field as 
specified here: 


Field Default 


ddnn: Your default device is established when you log in. SY0: 
is always your default device. Logging in assigns SY0: to 
some physical device. You can use SET DEFAULT to change the 
assignment of SyY0:; you can display the assignment with 
SHOW DEFAULT. (See Section 4.5.) Remember that you do not 
have to use the unit number for devices numbered 0. DB: is 
the same as DBO:, for instance. 


4-3 
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Field Default 


{g,m] Your default UFD is established when you log in. The 
default is the UFD that has the same group and member 
numbers as your UIC. You can change the default UFD with 
SET DEFAULT; you can display the default UFD with SHOW 
DEFAULT. (See Section 4.5.) 


etyp Standard file types (see Table 4-1) are used as defaults. 
There is not a default file type in every situation. 

ever For input files, the default is the highest numbered 
version; for output files, it is the next higher version 


number, or 1 if no previous version exists. 


The defaults make it possible for you to specify files without having 
to type in the full file specification. 


Suppose, for example, you log in with the UIC [200,20]. Your default 
device is DBO:, as recorded the System Account File, and assigned the 
name SY0:, and your default UFD is [200,20]. Assume further that 
there are three sequentially numbered versions of a file called 
TEXT.TXT in the directory. If you wish to print the highest numbered 
version of this file (version 3) on your terminal, all of the 
following forms of the TYPE command produce the same desired result: 


> TYPE TEXT.TXAT 

2TYFE TEXT. TXT#3 

»TYFE TEXT.TXT#O 

TYPE C200,;20]TEXT.TXTI3 

S TYPE DBGSTEXT. TAT 

STYFE DRO? L2007 2G TEXT. TX7 
SIYVPE Stl TEST eT AT 

STYFE SYiC2O0* 203 TEXT. TXT$3 
STTPE SYILLOOr2ZO4TEXT. PXEFO 


In most cases, you will use the first form, but if you wish to keep a 
permanent record of the terminal session, you may choose one of the 
more explicit forms. In any case, the system uses the final form 
given, as that form has all the defaults supplied. (Note that version 
0 will not always be version 3, but is the highest numbered version, 
which is number 3 by definition in this example.) 


Table 4-1 
File Types 
File Type Use 
-BAS BASIC-11 source program. System default. 
BAR: 
. BLD Indirect command file used by the SYSGEN procedure 
to . create files needed to build system tasks. 
System default. 
-B2S BASIC-PLUS-2 source program. System defauit. 
-CBL COBOL source program. System default. 


(Continued on next page) 


File Type 


~CMD 


-COR 


-DAT 


~-DIR 


- DMP 


-FTN 


- LOG 


-LST 


-MAC 


-MAP 


-MLB 


- OBJ 


- ODL 


- OLB 


- PAT 


- POB 


- PMD 


-SML 


-STB 
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Table 4-1 (Cont.) 
File Types 


Use 


Indirect command file. System default. 


SLP file used to correct a source file. System 
convention. 


File containing data, as opposed to code. System 
default. 


File is either Master File Directory or User File 
Directory. System default. 


Dump file created by File Dump Utility. System 
default. 


FORTRAN-IV, FORTRAN-IV-PLUS, or FORTRAN-77 source 
program. System default. 


Log of batch processing session. System default. 
Listing file. System default. 

MACRO-11 source program. System default. 

Task Builder map file. System default. 

Macro library. System default. 


Object module output from assembler or compiler. 
System default. 


File containing Overlay Descriptor Language to be 
used by Task Builder. System default. 


Object module library. System default. 


Correction file used by assembler to create patched 
object module. Must be specified. 


Patched object module input for PAT utility; must 
be specified. See Chapter 14 of the RSX-11M/M-PLUS 
Utilities Manual for more information on file types 
-PAT and .POB. 


File containing Postmortem Dump of interrupted task. 
System default. See the RSX-11M/M-PLUS Task Builder 
Manual for more information. 


File containing system macro library. Other macro 
libraries have the type .MLB. System default, but 
must be specified on input file. 


Symbol definition file created by Task Builder. 
System default. See Section 6.4 and the 
RSX-11M/M-PLUS Task Builder Manual for more 
information. 


(Continued on next page) 
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Table 4-1 (Cont.) 


File Types 
File Type Use 
~SYS A bootable system image. System default. 
. TMP A temporary file. System convention. 
- TSK Task image file. System default. 
He Sh A text file. System convention. 
.-ULB Universal library. System default. 


4.1.4 Wildcards in File Specifications 

In addition to the regular defaults for the current device, the 
current UFD, and the most recent version, you can use wildcards with 
the commands in this chapter to set up temporary defaults for every 
part of the filespec except the device name. 


Simple wildcarding uses the asterisk (*) to replace all or any field 
in the filespec. 


For instance, the command 
SDIRECTOGRY £3034] 


lists all files on the default volume with the group number 303, 
regardless of member number, and 


SOTRECTORY (krS3 


lists all files on the default volume with member number 5, regardless 
of group number. 


The command 
SDIRECTORY CXskI TEXT. TKT 


lists the most recent versions of all files on the default volume 
named TEXT.TXT, regardless of the group or member number. 


Likewise, the * in place of the version number means "all versions". 
The command 
ZTIRECTORY WOM. BAT? * 


lists all versions of the file WOM.BAT on the default volume and in 
the default UFD. 


The * can also be used to replace an entire file name or file type in 
much the same way. 


SDIRECTORY &. BAT 


lists the most recent versions of all files with the type .BAT and any 
name on the default volume and in the default UFD. 
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The command 
“TIRECTORY CUNMON. # 


lists the most recent versions of all files with the name COMMON and 
any type on the default volume and in the default UFD. 


The examples thus far have demonstrated the simple form of 
wildcarding, using the * to replace an entire field in a filespec. 
Simple wildcarding works with all the commands in this chapter. The 


PRINT command accepts simple wildcarding, as does the SUBMIT command 
for RSX-11M-PLUS batch processing. Many utilities also accept simple 
wildcarding. See the RSX-11M/M-PLUS Utilities Manual for information 
on how each utility handles wildcards. 


Most of the commands in this chapter work through PIP, the Peripheral 
Interchange Program. For the PIP-related commands, DIRECTORY, DELETE, 
PURGE, COPY, RENAME, TYPE, APPEND, UNLOCK, and SET PROTECTION, a more 
elaborate form of wildcarding is available. In these commands, within 
file names and file types, the * can be used in a more complex manner. 
The * actually means "match zero or all characters in this position." 


Therefore, the command 
SDIRECTORY Lx. TXT 


lists the most recent versions of all files with the type .TXT whose 
nmames start with L on the default volume and in the default UFD. 


And the command 
S“TIRECTORY *L&.TZT 


lists the most recent versions of all files with the type .TXT whose 
names include an L on the default volume and in the default UFD. 


The same substitutions can also be used in file types, so that the 
command 


STIRECTORY SNOBLO.L# 
lists the most recent versions of all files with the name SNOBLO and 
the type beginning with an L on the default volume and in the default 
UFD. 
You can use more than one wildcard in file names and file types. 
The command 


SDIRECTORY xXF ROK. TXT 


lists the most recent versions of all files with the type .TXT whose 
names include an F and a D in that order. 


In addition, the PIP-related commands permit the percent sign (%) to 
be used as a wildcard, but only within file names and file types. The 
% means "match exactly one character in this position." 


The following command, for instance 
2DIRECTORY “4. TXT 


lists all files with the type .TXT and a single-character file name on 
cne 


he default volume in the default UFD. 
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The command 

SDIRECTORY NOVEL .TAT 
lists all files with the type .TXT and a file name consisting of NOV 
and 81 separated by two characters on the default volume in the 
default UFD. 
The wildcards can be combined in a single filespec. 
The command 

POIRECTORY ZL&T. Mx 


lists all files whose name 
an L and end with a 


another einala aha 
alive iL we tsi wLIiankL NN 


s begin with a single character followed by 
T and with a file type consisting of .TM and 
on the default volume in the default UFD. 
Wildcarding, combined with systematic policies of UFD assignments, 
file names, and file types can add considerable flexibility and 
convenience to your use of the system. 


In addition, the PIP-related commands, DIRECTORY, DELETE, PURGE, COPY, 
RENAME, TYPE, APPEND, UNLOCK, and SET PROTECTION also accept several 
other qualifiers that add further flexibility to these commands. 


First, there are the date-oriented qualifiers: 


/DATE:dd-mmm-yy 

/SINCE: dd-mmm-yy 

/ THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/ THROUGH :dd-mmm-yy 
/TODAY 


These qualifiers all depend on the creation date of the file as shown 
in the DIRECTORY listing. /DATE limits the operation of the command 
to files created on the specified date. /SINCE limits the operation 
of the command to files created on or after the specified date. 
/THROUGH limits the operation of the command to files created before 
or on the specified date. /SINCE and /THROUGH can be combined to 
limit the operation of the command to files created within a given 
range of dates. /TODAY limits the operation of the command to files 
created on the same day the command was issued. 


You can enter the date in either of two forms: 


dd-mmm-yy as in 25-DEC-82 
or 
mm/dd/yy as in 12/25/82 


The system always displays dates in the first form. 

The PIP-related commands also accept the following qualifier: 
/EXCLUDE: filespec 

The /EXCLUDE qualifier allows you to exclude a file or files from the 

operation of the command. The filespec argument to /EXCLUDE must 


include a version number, but the version number can be *. Wildcards 
are accepted for all parts of the filespec argument to /EXCLUDE. 


HANDLING FILES 


4.1.5 File Protection and Volume Protection 


Data privacy and system security are provided by restrictions on 
access to volumes and the files on the volumes through volume 
protection and file protection. Volume protection refers to access to 
a mounted volume. You must have access rights to the volume before 
you can have access to any file on the volume. This access is 
determined through a protection code. 


Once you have access to the volume, you must then have access to the 
file. File access is also determined through a protection code. The 
volume protection code and file protection code are slightly different 
because their functions are slightly different. The differences are 
noted in the following description. 


Each file has a protection code, which specifies whether different 
kinds of system users who may access to the file, and what they may do 
to the file when they access it. 


There are four kinds of users: 


SYSTEM The operating system itself, and privileged users, those 
having group numbers of 10 or less. 


OWNER The user having the same UIC as that the file was 
created under. 


GROUP All users having the same group number as that the file 
was created under. 


WORLD All other users. 
There are also four kinds of access to files: 


READ The user, or the user's tasks, may read, copy, print, or 
type the file, and if it is a task, run it. 


WRITE The user, or the user's tasks, may add new data to the 
file by writing to it. 


EXTEND The user, or the user's tasks, may change the amount of 
disk space allocated to the file. 


DELETE The user, or the user's tasks, may delete the file. 


These forms of protection are expressed with a single character for 
each, The default protection applied to all files on the system that 
have not been otherwise protected is: 


SYSTEM: RWED,OWNER: RWED,GROUP: RWED,WORLD:R 
See also the discussion of directory protection in Section 4.2.2. 


Volume protection codes differ from file protection codes in that 
EXTEND protection is called CREATE protection. The function of the 
code is the same. Either EXTEND protection or CREATE protection 
refers to the right to allocate space on a volume. CREATE under 
volume protection refers to your ability to allocate space for a new 
file, while EXTEND under file protection refers to your ability to 
allocate space within an existing file. 


The default protection applied to all volumes on the system that have 
not been otherwise protected is: 


SYSTEM: RWCD, OWNER: RWCD,GROUP: RWCD,WORLD:R 
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CREATE 


In fact, you can use a C in a file protection code or an E in a volume 
protection code and the command will be accepted, but it is good 
practice to use the correct protection category. 


4.2 CREATING DIRECTORIES AND SEQUENTIAL FILES 


The CREATE command without a qualifier enables you to create a 
sequential file directly at your terminal. The CREATE/DIRECTORY 
command permits a privileged user to create a User File Directory 
(UFD). 


£ 


4.2.1 CREATE 


CREATE creates a sequential file and enables you to type text directly 
into the file from your terminal without using an editor. 


Format 


CREATE 
File? filespec 


CREATE filespec 
Parameter 
filespec 
Specifies the name of the file to be created. 


As soon as the command is entered, the cursor (or print head) 
moves down ae line. The file is open for input. Any text you 
type goes into the file. 


When you have finished entering text, type a CTRL/Z to close the 
file. 


If you wish to create an empty sequential file, simply enter the 
CTRL/Z first. See examples. 


Examples 


SCREATE (ET 
File? COPY.Cmn (QED 
+ Command file to move files trom Hank’ s UFD to me UFD RET 
«ENABLE SUBSTITUTION RED 
»LOQOF RET 
‘ASKS FI What fade (QE 
COFY UBS CL 303s2ea 47°F To ord RED 
»-G0TO LOOF RED 


| 


CTRL Z 
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CREATE/DIRECTORY 


In this example, the user wanted to move a number of files from 
one directory to another. With CREATE, the user created an 
indirect command file at the terminal. After entering the CREATE 
command and filespec, the cursor (or print head) moves to the 
left margin. The terminal is attached for input to CREATE. Note 
that while CREATE is executing, the RETURN key acts only as a 
carriage return, and not as a means of entering commands to the 
system. No commands are accepted by DCL until after the CTRL/Z 
(echoed as “Z). 


“CREATE JOE.TXT 


Joe called et 4136 on Monday. He’ll oe beck from Switzerland om (BEL 


Thursday: but he won’t be in the office until Fridays etternmnasearn, (CTRLzZ) 


In this example, the user used CREATE to take notes on a= phone 
call. 


“CREATE CHURCHYLA.FEM (QED 
CTRL'Z 


In this example, the user used CREATE to create an empty file for 
later use. 


Notes 


CREATE differs slightly in batch jobs. See the RSX-lLIM/M-PLUS 
Batch and Queue Operations Manual for further information. — 

If you create a file without specifying a version number and _  0no 
file of that name and type exists, the file is version 1. If a 
file of that name and type exists and you give no version number, 
the new file has a version number one higher than the highest 
numbered previous version. 


If you specify a version number when creating the file, the 
system creates a file with the version number you give. If there 
is already a file with the same name, type, and version number, 
that file is deleted and replaced by the file you created. 


If you use CTRL/U when creating a sequential file, the text on 
the line is eliminated, but not the line itself. In other words, 
CTRL/U leaves a blank line behind when it deletes a line. 
CTRL/U, CTRL/R, and the DELETE key are the only editing 
facilities available to you when creating sequential files at the 
terminal. 


4.2.2 CREATE/DIRECTORY 


CREATE/DIRECTORY creates a User File Directory (UFD) on ae Files-1l 
volume and enters the UFD into the volume's Master File Directory 
(MED) . ‘ 
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Privileged users can create UFDs on volumes mounted on any device. 
Nonprivileged users can create UFDs only on volumes mounted on their 
own private (allocated) devices. 


Format 


CREATE/DIRECTORY[/qualifier[s] ] 
Device, UFD? [ddnn:][[g,m]] 


CREATE/DIRECTORY[/qualifier[s]] [ddnn:][{9,m]] 
Command Qualifiers 


/ ALLOCATION: n 
/ PROTECTION: code 
/ LABEL: volumelabel 


Parameters 
{ddnn:][([{g,m] ] 


You must specify at least one of these parameters. If you 
specify one parameter, the default volume or UFD is used for the 
other parameter. You cannot create a directory that matches both 
your default device and your default UFD. 


ddnn: 


Specifies the device on which the volume vou wish to create the 


ewe ee we 


directory is mounted. This parameter defaults to SY0:. 
The volume must be a mounted, Files-11 volume. 
[g,m] 


Specifies the group and member numbers of the directory you wish 
to create. This parameter defaults to the current UFD. 


Command Qualifiers 
/ALLOCATION:n 


Specifies the number of directory entries (file names) for which 
space is to be allocated. n is rounded uv to the next multiple 
Of) 32% 


The default is /ALLOCATION: 32. 
/ PROTECTION: (code) 


Specifies the protection code for the directory file, not for 
files in the directory. Since the directory is a file, READ 
access is the right to list the directory, and WRITE access is 
the right to create files in the directory. If you do not have 
EXTEND access to a directory, you may be denied the right’ to 
create more than a certain number of files in the directory. 
DELETE access means the right to delete the directory file. If 
you delete a directory file, you must use the VFY utility to 
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recover files from the directory. See Chapter 9 of the 
RSX-11M/M-PLUS Utilities Manual. 


The default is the protection code the disk was mounted with. 
The default for mount protection is the protection code the 
volume was initialized with. 


The default system protection code is: 
/PROTECTION: (SYSTEM: RWED, OWNER: RWED, GROUP: RWED,WORLD:R) 


See also Sections 4.1.5 for more information on file and volume 
protection. 


/LABEL: volumelabel 


Specifies that the volume label that you supply be compared with 
the label on the volume. If the names match, a UFD can be 
allocated. If they do not match, the command is rejected. 


If you do not specify this qualifier, the volume label is not 
checked. 


Examples 


SCREATE/DIRECTORY 
Tevicer UFD?F UDR2:0303957 


This example creates UFD [303,5] on the volume mounted on device 
DB2:. Nonprivileged users can create directories only on volumes 
mounted on a device they have allocated. Privileged users can 
create directories on volumes mounted on any device. 


7CREATE/DIRECTORY DRS3C303 25) 
This example is identical to the previous one. 
>CREATE/DIRECTORY 
Devices UFO? C222,222) 
This example creates UFD [222,222] on the default device. 
~CREATE/DIRECTORY 
Devices UFG? DRS: 
This example creates a directory on the volume mounted on DB6: 
with the same group and member number as the default UFD. 
“CREATE/TIRECTORY/FROTEU TIONS CSYSTRWEDS OWNTR > GRO RR» WORLD IR) 
Devices UFD? OR2ICLiGGs toc 
This example creates UFD [100,100] on the volume mounted on 
device DR2:. The protection code is the protection code applied 


to the actual file containing the directory, DR2:[0,0]100100.DIR. 
The code in this example permits privileged users to perform all 
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operations on this file: READ (list the directory), WRITE (add 
files to the directory)/, EXTEND (alter the size of the directory 
file), and DELETE (delete the directory file). All other users 
can READ (list) the directory only. This protection mask has no 
relationship to the protection applied to files in the directory, 
or to volume protection, both of which may differ from the 
protection applied to the directory file. See Section 4.1.5. 


4.2.3 EDIT 
EDIT or EDIT[/EDT] invokes EDT, the DEC standard editor. 


EDIT/SLP invokes the Source Language Input Program, a program 
maintenance utility. EDIT/EDI invokes EDI, the Line Text Editor. 
EDIT also invokes KED and K52, if present, and any unsupported editors 
you may have in your installation. The default is EDIT[/EDT]}. 


4.2.3.1 EDIT[(/EDT] 


EDIT invokes EDT, the DEC standard Editor. See the EDT Editor Manual 
for more information. 


Format 

EDIT[/EDT1] [/aqualifier!s]] infile 
or 

EDIT [/qualifier[s]] infile 
Command Qualifiers 
/{NO] COMMAND [:filespec] 
/ [NO] JOURNAL[:filespec] 
/(NOJ]OUTPUT[:filespec} 
/{NO] READ ONLY 
/ [NO] RECOVER 

Parameter 

infile 


Specifies the file to be edited. If the file does not exist, EDT 
creates it. 


You must supply a file name, but the type can be null. 

Command Qualifiers 

/ {NO] COMMAND[:filespec} 
Controls whether an EDT initialization file is read by EDT before 
editing begins. These files contain commands that alter the 
default setup for EDT, such as custom line-mode commands) and 


change-mode key definitions. 


The default is /COMMAND:EDTINI[.EDT] . 
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EDIT/EDT (Cont.) 


If you use this qualifier and EDTINI.EDT or some other file you 
name does not exist, EDT issues no error message and continues 
with the editing session. 


If you have a file EDTINI.EDT and do not wish to use it, use the 
/NOCOMMAND qualifier. 


/ [NO] JOURNAL[:filespec] 


Controls whether EDT creates a journal file for the editing 
session. The default is to create a journal file with a file 
name the same as that of the input file with the type .JOU. You 
can specify a different name by including a filespec. 


The journal file consists of all editing commands and text 
entered during the session. If the editing session ends 
abnormally, such as through a system crash, or your inadvertently 
typing three CTRL/ZS in succession, the journal file is saved. 
In such a case, you invoke EDT again, with the same command line 
as before plus the /RECOVER qualifier. Your editing session is 
repeated and all your editing is restored. If the editing 
session ends normally, the journal file is deleted. 


If you specify /NOJOURNAL, no journal file is created and no 
recovery is possible. 


/(NO] OUTPUT[:filespec] 


If you do not specify this qualifier, the default is to create a 
file of the same name and type as the input file with a version 
number one higher than the input file. If the file is new, EDT 
creates version number 1. You can alter the name of the output 
file by including a filespec with the /OUTPUT qualifier. 
Otherwise, the qualifier need not be included. 


If you specify /NOOUTPUT, you cannot exit EDT without including a 
filespec in your EDT EXIT command. 


/{NO]READ ONLY 


Specifies whether you wish simply to read the file or to edit it. 
If your command line includes /READ ONLY, you can use the full 
facilities of EDT, but you cannot exit without including a 
filespec in your EDT EXIT command. Normally, you would use the 
EDT QUIT command if you had specified /READ ONLY. The /READ ONLY 
qualifier is equivalent to a combination of /NOOUTPUT and 
/NOJOURNAL. You can use /READ ONLY to look at files to which you 
have no write access. =. 


The default is /NOREAD ONLY, which need never be specified. 
/ [NO] RECOVER 


Specifies whether EDT reads commands from a journal file prior to 
starting the editing session. With a journal file, your editing 
session can be restored if interrupted by a system crash or other 
problem. The default is /NORECOVER, which need never be 
specified. 


HANDLING FILES 
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The /RECOVER qualifier requests EDT to open the input file and 
then read EDT commands and text from the file with the same file 
name as the input file and the file type .JOU. The command line 
with /RECOVER added to it must be identical to the command line 
that initiated the original failed editing session. This means 
that if you specified an EDT initialization file, you must 
specify the same file in the /RECOVER command line. And, if you 
specified a name for the journal file other than infile.JOU, you 
must include the /JOURNAL qualifier with the appropriate 
filespec. If journaling was not enabled on the original command 
line, you cannot recover the editing session. 


Examples 


2 EDIT 

File? HORNBLOW. TAT 

Ineut file does mot exist 
CEOQBI 

x 


This example shows the EDIT command in its simplest form. The 
file HORNBLOW.TXT is created during the editing session. 


EDIT HORNBLOW, TXT 
This is the one-line form of the same command. 


SEDIT/OQUTFUTIUMPIRE. MAC WEAVER. MAL 
1 +TITLE WEAVER 
x 


In this example, the user takes an existing file as input and 
edits it to create a new file. 


SPEDIT/COMMAND? FORMAT RAMBLE. RNG 
Ineut file does mot exist 

CEORJ 

4 


In this example, the user prepared an EDT initialization file 
called FORMAT.EDT. This file contains EDT command definitions 
designed to be used with a text formatting program. See next 
example. 


SEDIT/COMMANDIFORMAT/RECOVER SANBLE.L RNG 
1 This is FORMAT.EDT. Version 244 Ambrose Brerces Meinteiner 


+ 


During the editing session started in the previous example, the 
system crashed. Once it was back on the air, the user duplicated 
his original command exactiy, naming the same EDT initiaiization 
file and then added the /RECOVER qualifier. EDT begins 
reproducing the entire editing session, beginning with reading in 
the initialization file, the first line of which is seen in the 
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example. All the editing commands and text entered during the 
session have been recorded in the file RAMBLE.JOU, which is also 
read back in by EDT. The result is that the entire editing 
session is repeated up to within a few keystrokes of the crash. 


If you wish to test the recovery procedure, start editing a file 
and then enter three CTRL/Zs as line-mode commands. This causes 
an unnatural exit from EDT, so the journal file is saved. You 
can then dubdlicate the original command line, add the /RECOVER 
qualifier, and watch yourself edit. 


Notes 


See the EDT Editor Manual for more information on journaling, 
initialization files, command and key definitions, and the other 
editing functions of EDT. 


The qualifiers used with EDIT/EDT will not work with other forms 
of the EDIT command. If you use the /EDT qualifier, it must 
appear immediately after EDIT on the command line. Other 
qualifiers can float. 


You can use the MCR command to invoke EDT in a different format 
that some users may find more convenient. See the EDT Editor 
Manual for the alternate command format. 


4.2.3.2 EDIT/SLP 


EDIT/SLP invokes the Source Language Input Program (SLP), an editor 
designed for maintaining and updating source files. SLP enables you 
to delete, replace, or add lines to an existing file or create source 
files. SLP also has an optional audit trail which enables you to keep 
track of changes in the file. See Chapter 13 of the RSX-~11M/M-PLUS 
Utilities Manual for more information on SLP. 


Format 
EDIT/SLP[/qualifier[{s]] infile 
Command Qualifiers 


/{NO] AUDIT[:arg] 
POSITION:n 
SIZE:n 

/ [NO] CHECKSUM [:arg] 

/ [NO] LIST[:filespec] 

/ [NO] OUTPUT[:filespec] 

/{NO] REPORT 

/ [NO] TAB 

/ [NO] TRUNCATE[:n] 


HANDLING FILES 
EDIT/SLP (Cont.) 


Parameter 
infile 

The input file is the source program to be updated by SLP. 
Qualifiers 


/(NO] AUDIT[: (arg[s])] 
POSITION:n 
SIZE:n 


Controls whether the output file includes an audit trail, and 
optionally allows you to specify the location and size of the 
audit trail. You can specify one or both of these values. If 
you specify only one, you can omit the parentheses, but the 
parentheses are required syntax if you specify both POSITION and 
SIZE. Separate the two arguments within the parentheses by a 
comma (,). 


The POSITION: argument sets the starting position of the audit 
trail. The value of n can be from 0 through 132, representing 
the column at which the first character in the audit trail is to 
appear. This value is rounded up to the next highest tab stop. 
The default is to start the audit trail at column 80. Note that 
this default causes audit trails of more than a single character 
to wrap around when displayed on standard video terminals. 


The SIZE: argument sets the length of the audit trail. The 
value of n can be from 0 through 14. The default is an audit 
trail of 8 characters. 


The audit trail itself is defined from within SLP. See Chapter 
13 of the RSX-11M/M-PLUS Utilities Manual. 


/ {NO] CHECKSUM[:arg] 


Controls whether a checksum is calculated for the SLP commands. 
If you specify checksum without an argument, SLP calculates the 
checksum value and prints it on your terminal. If you specify an 
argument, SLP calculates the checksum and compares it to what you 
have specified. If the numbers differ, a warning message is 
displayed, but the execution of SLP is not interrupted. 


The default is /NOCHECKSUM,. 

/{NO]LIST[:filespec] 
The /LIST qualifier creates a listing of a file with line 
numbers. If you do not give a filespec, the default filespec is 


filename.LST. 


The default is /LIST. /NOLIST suppresses creation of the listing 
file. 
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/ [NO] OUTPUT{:filespec] 


Use this qualifier to change the name of the output file. The 
default output filespec is the same name and type as the input 
file and a version number one higher than the highest existing 
version of the file. If you do not wish to override this 
defauit, you do not need this qualifier. 


The /NOOUTPUT qualifier suppresses the creation of an output 
file. 


/ {NO] REPORT 


Controls whether line truncations that result from audit trails 
are reported. If you specify /REPORT, you receive warning 
messages on your terminal and the affected lines are marked with 
a question mark (?) in place of the period (.) in the line number 
in the listing file. 


The default is /NOREPORT. 
/ [NO] TAB 


Controls whether SLP replaces tabs or spaces at the end of each 
record containing an audit trail. If you specify /TAB, tabs are 
inserted. If you specify /NOTAB, spaces are inserted. The 
default is /NOTAB. 


/ [NO] TRUNCATE[: arg] 


The TRUNCATE qualifier requests SLP to truncate each record in 
the input file when it creates the output file. This qualifier 
allows you to delete an audit trail from a file previously 
updated with SLP. If you specify /TRUNCATE without a number, SLP 
truncates input records at the beginning position of the audit 


trail. If you specify a number, SLP truncates the records 
beginning at the column. The value of n can be from 0 through 
132. 


The default is /NOTRUNCATE. 
Notes 


You must understand how to use SLP to use this command. See 
Chapter 13 of the RSX-11IM/M-PLUS Utilities Manual for more 
information. 


The qualifiers used with EDIT/SLP will not work with other forms 
of the EDIT command. The SLP qualifier must appear immediately 
after EDIT on the command line, but other qualifiers can float. 


From MCR, you can invoke SLP in a different format that some may 
find more convenient. See the Utilities Manual for the alternate 
command format. 
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4.2.3.3 EDIT/EDI and EDIT/editor 


EDIT/EDI invokes EDI, the Line Text Editor. The EDIT command can also 


be 
with 


used to invoke KED and K52, which are supported but not bundled 


RSX-LIM/M-PLUS systems as well as various unsupported editors. 


Format 


EDIT[/qualifier] [edit-input] 


Command Qualifiers 


/EDI 
/USING: yyy 
/SOS 

/TECO 


/MAKE 


/MUNG 
/KED 
/K52 


/OUTPUT: filespec 


/CREATE 
/{NO] READ_ONLY 


Parameter 


edit-input 


Any valid input to the chosen editor may be supplied here. 
Usually this will be a file specification, but anything, 
including a carriage return, that is valid for the chosen editor 
is a proper parameter for this command. 


Command Qualifiers 


Only one qualifier can be specified. This qualifier identifies 
the editor or function you wish to access. 


/EDI 
Specifies EDI, the Line Text Editor, an interactive, 
line-oriented editor used to create and maintain text and source 
files. See Chapter 2 of the RSX-11M/M-PLUS Utilities Manual for 
more information on EDI. 

/USING: yyy 
Specifies that an editor not supplied by DIGITAL is being used, 
where yyy is the installed name of the editor. 

/SOS 


Specifies the unsupported editor, Son of Stopgap. 
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/TECO 
/MAKE 
/MUNG 


Specifies functions of the unsupported editor, Text Editor and 
Corrector. 


/KED 

/K52 
The /KED qualifier invokes KED, the Keypad Editor, which is part 
of the Forms Management System (FMS-11) software. FMS-1l1 is not 
bundled with RSX-11M/M-PLUS systems. The /K52 qualifier invokes 
a version of KED for VT52 terminals. 
Other EDIT qualifiers for use with KED or K52 are /CREATE, 
/OUTPUT, and /[NO]READ ONLY. 

/CREATE 


Use /CREATE with EDIT/KED or EDIT/K52 when you wish to edit a 
file that does not exist. 


/OUTPUT: filespec 


Use /OUTPUT with EDIT/KED or EDIT/K52. If you do not’ specify 
this qualifier, the default is to create a file of the same name 
and type as the input file with a version number one higher than 
the input file. You can alter the name of the output file by 
including a filespec with the /OUTPUT qualifier. Otherwise the 
qualifier is not needed. 


If you specify /NOOUTPUT, no output file is created when you exit 
KED. 


/{NO] READ ONLY 


Specifies whether you wish simply to read the file or to edit it. 
If your EDIT/KED or EDIT/K52 command includes /READ ONLY, you can 
use the editor, but you cannot create a new version of the file. 
/NOREAD ONLY is the default and need not be specified. 


Examples 


PEDIT/EDI CHILI.MAC#2 
[00066 LINES READ INI 
CFAGE it 

¥ .. 


This example invokes EDI and names an existing input file. 
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SEDIT/SOS HARRY.MACHS 
EqgitiDBOilC7?s 7IHARRY. MAC SS 
* 


This example invokes SOS for a file that already exists. 


SEDIT/SOS LONNNY. HAC 
TneutiDkOil?s 7 ILONNNY, MACE I 
0061090 _ 
This example invokes SOS for a file that is being created. 


SEDIT/TECO FUNK. TST 
x 


This example invokes TECO for a file that already exists. 
2EDIT/MAKE JUNK. TST 
* 

This example invokes TECO for a file that does not exist. 
SEDIT/MUNG DOIT 
Outeut derends on file. 

This example invokes TECO where DOIT is a file of TECO commands. 

Notes 
There are no prompts from this form of the command. 


No checking of the edit-input parameter is performed by DCL. The 
editor does all the checking. 


The unsupported editors SOS and TECO are _ found on many 


RSX-1L1IM/M-PLUS systems. Commands to access these editors ar 
included only for the convenience of users. No support is 
implied. 


4.3 MAINTAINING A DIRECTORY 
The following commands provide you with the means for keeping your 


directory up to date. Disk space on mass storage devices is an 
important resource. You should not keep files that you do not need. 


4.3.1 DIRECTORY 


Format 


DIRECTORY [/format-qual] [/destination-qual] [filespec[s] ] 
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Command Qualifiers 
Format 


/FULL 
/BRIEF 
/EREE [ddnn:] 
/ SUMMARY 

/ ATTRIBUTES 


Destination 


/PRINTER 
/OUTPUT: filespec 


Other 


/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH :dd-mmm-yy 

/SINCE: dd-mmm-yy/THROUGH:dd-mmm-yy 
/ TODAY 

/ EXCLUDE: filespec 


Parameter 
filespec[s] 


Specifies the file or files for which information should be 
displayed. If you do not supply a filespec, a complete directory 
for the default UFD is displayed. 


You can supply one or more filespecs, separated by commas, and 
directory information on the files you name is displayed. 


You can use wildcards in place of any filespec field except the 
device field. If you do not supply a version number, only 
information on the most recent versions is displayed. However, 
if you do not supply a file type, a null file type is assumed. 
If you do not know the file type, use a wildcard. 


You can display a directory for another UFD by supplying the UFD 
in this field. You can also specify device names in the form 
ddnn: in this field. 
If you name files in two directories, you should name files for 
the default UFD first. If you name files from another device or 
directory first, the defaults are canceled. See examples. 
Command Qualifiers 
Command qualifiers are in three groups: 


1. Format qualifiers control the appearance of the directory. 


2. Destination qualifiers control where the command output is 
sent. 


3. Other qualifiers modify the list of files by creation date or 
exclusion. 


HANDLING FILES 
DIRECTORY (Cont.) 


If you do not supply a format qualifier, the display is in standard 
format, giving the file name, type, and version number, the number of 
blocks the file occupies, and the date and time of creation. 


If you do not include a destination qualifier, the display appears on 
your terminal. 


If you do not include any of the other qualifiers, the display 
includes all files that otherwise qualify. 


Format 
/BRIEF 


Specifies that the display give file names, types, and version 
numbers only. 


/EULL 


Specifies that the complete directory entry be displayed, 
including File ID number, blocks used and allocated, the owning 
UIC, protection status of the file, in addition to all the 
information in the standard display. 


/ SUMMARY 


Specifies that the display give only the total number of blocks 
allocated and used for the specified files. If you give no 
filesnecs in the command, the display shows the total hlocks 
allocated and used for the default directory. 


/FREE [ddnn:] 


Specifies that the display give the free space and number of free 
file headers on the default device or a specified device. 


/ATTRIBUTES 


Displays the Record Management Services (RMS-11) attributes of a 
file or files. This display includes file name and type, 
creation date and time, file organization, protection status, 
allocation information, last access date and time, record format, 
record size, primary and alternate key definitions for indexed 
files, and bucket size .for indexed and relative files. This 
qualifier invokes the RMS-11l DSP utility. Note that this display 
is produced for any file you specify in a DIRECTORY command, 
whether or not the file is an RMS-1l file. Some display 
information may not be meaningful for non-RMS files. See the 
RMS-11 documentation supplied with your system. 


Destination 


These qualifiers direct output to an output file or to the line 
printer. 


/OUTPUT: filespec 


Specifies that the output of the DIRECTORY command be placed ina 
file having the filespec you supply. 


HANDLING FILES 
DIRECTORY (Cont.) 


/PRINTER 


Specifies that the output of the DIRECTORY command be printed on 
your system's line printer. (RSX-LIM-PLUS only.) 


Other 
/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the DIRECTORY command 
to list only files created on the date given. 


/ SINCE: dd-mmm-yy 


The /SINCE qualifier specifies that you wish the DIRECTORY 
command to list only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the DIRECTORY 
command to list only files created on or before the date given. 


/SINCE:dd-mmm-yy/ THROUGH :dd-mmm-yy 
The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the DIRECTORY command to list only files created 
within that range. 

/ TODAY 
The /TODAY qualifier specifies that you wish the DIRECTORY 
command to list only files created on the same day the command is 
being issued. 

/ EXCLUDE: filespec 
The /EXCLUDE qualifier specifies that you wish the DIRECTORY 
command not to list certain files. The filespec argument to 
/EXCLUDE can contain wildcards, but the version number must be 
given, either explicitly, or as "*" wildcard. 

Examples 


DIRECTORY 


Birectory DBIiC 263357 
T-NOV-82 142164 


AsAdi Ls ea-SEP“o2. 1272 

ANIML.«BAS#1 4s S4-NAR-Be2 17S 
AZ.CHIsS 1. O2-APR-Ge 14503 
BYE.CMIts 1 1. Zo SRPHB 2 eee? 
CLEAN. CMDs 1 1. 1O-JAN-B2 O8729 
DUN. CMDs 4 1. 23-JAN-82 O8IO5 
ENT. CMDs Ze 1. O7-NOY-82 15:56 
LOX.CMDs1 1. 27-APR-B82 10721 
LOGIN. CMI 4 1. O6-AFR-82 15°56 
TI-CMD? 4 1. SO-APR-82 O87336 


HANDLING FILES 


DIRECTORY (Cont.) 


F,TSKF1 4. C 25-SEF-82 12330 
G.TSK1 4. C 25-SEP-82 12330 
FONG. TSKs2 12. C 29-SEP-82 12:31 
BUZZ,.TXT#2 4. 12-MAR-82 09°13 
IZZY.TATS1 2s O6-HMAR-B82 14533 
JIVE.TXT#1 i. 16-NOV-82 13323 


Total of 2906./3043. Blocks in 160. Files 


This example shows a directory listing in the standard format. 


The device and UFD are named at the head of the listing, along 
with the date and the time. All files in the UFD are listed 
because the user did not supply any filespecs. The files shown 
with a CC in column 3 are contiguous files, in this case, task 
images. You may see files in a directory with an L in this 
position, signifying that the files are locked. Files are locked 
when they are closed improperly. See Section 4.4.6 for 
information on the UNLOCK command. 


DIRECTORY /SUMMARY 

Storage used/allocated for Directors DB1{(£303+5)] 

1-NOV-82 14°15 

Total of 2892./3033. blocks in 160. files 
This example displays the output produced by the /SUMMARY 
qualifier. If the user had supplied one or more filespecs in the 


command, the summary would cover the blocks used and allocated 
for the specified files only. 


“DIRECTORY/FREE 
DRI: has 13742, blocks freer 32769280. blocks used out of 340670, 
Largest comtisguous space = 5173. blocks 


124420 file headers are freer 131510. nesders used out of 25593, 


This example displays information about the default device. 


“DIRECTORY/FREE LEO: 


DRO? has 6074. olocks freer 334596. blocks used out of 340670. 
Largest comtisuous srece = 3520. blocks 
$297. file headers are free: 22296, headers used out of 25593. 


HANDLING FILES 
DIRECTORY (Cont.) 


This example displays information about the pseudo device LBOQ:. 
Notice that the display gives the physical device name for the 
pseudo device. 


DIR TI.CME 


Directors DBLtC303+5] 

1-MAY-82 14:17 

TI.CMD 4 1. ZO-APR-B2 O8136 

Total of 1./5. blocks in i. file 
This example displays information on the most recent version of 
the file named. See next example. 


“DIR TI.CMD: ® 


Directory URItC 30395] 
1-MAY-82 14:17 


TI.CMDs4 1. SO-APR-82 O83 36 
TI,CMDs 3 1. SP ORER SE 2) Ley oS 
TI.LCMDs 2 ts 2/-APR-G2 143 29 
TILCMEG 1 1. Z2?-APR=“82 26.23 


Totel of 4.720, blocks in 4. files 


This example displays information on all versions of the file 
named because the user supplied a wildcard for the version 
number. 


PDIR/FULL TI.Cwn 


Directory DBI? 0C308:5) 
1-MAY-82 14°17 


TI.CMES4 (300754) 1,./5- SO-AFR-82 O8336 [30255] CRWEDyRWED,RWEDs RI 
Totsl of 1.7/5. alocks in Ii. file 


This example displays full information on the most recent version 
of the file named. The number in parentheses is the file 
identification number assigned by the system when the file is 
created. The first number is the file number, the second is the 
sequence number of the file. The UIC is the UIC of the owner, 


HANDLING FILES 
DIRECTORY (Cont.) 


and the final column is the protection status of the file. See 
notes. 


Protection status is listed in the order system, owner, group, 
world. See Section 4.1.5 for an explanation of protection status 
and how it can be altered. 


SOITRECTORY/ERIEF &*.CMD 


Tiirectory TRLitl 363,53 


ALNV. CMDs 2 
AZ-CMD eS 
BYE.CMDs1 
CLEAN. CMIis id 
DAY.«CMLFi 
UTC. CMDs i 
DUN. CME 4 
ENT.CMD 22 
LOX.CMDs 4 
VIR. CMI 1 


This example displays brief information on the most recent 
version of all files of the type .CMD in the default UFD. 


=DIRECTORY/TODAY 


Ttirectory TRE: 030355) 
B-NOV-82 LEt44 
Tey of S-NOV-G2 


OSJANS2.LGI> 1. 0. OS-NOV-82 08:2 
ZOSLCHA. MEM? 1 SO? s OS-NOV-82 10711 
NEWINSDCS.RNOs 7? 1. QOS-NOV-82 103065 
2OS1CH4. MEMS 2 320, OS-NOV-B2 10312 
FUT+MAT Fi i+ VENOUS GS PaCS 
NEWINSDCS.RNO?6 o, OS-NOV-B82 99735 
NEWINSDCS.RNG#10 10, OS-NOV-B2 107.3% 
NEWINSDC4,RNOFS Fe OS-NOV-82 11244 
FRK.CMIGS 1. OS-NOV-82 13:43 
NEWINSIC4, RNOGS 4 li. OS-NOV-82 137343 
LOG.LOGs1 Os OS-NOV-82 13343 


Total of 708./736. blocks in 11. files 


In this example, the user asked for a directory of all files 
created the same day the command was issued. Note tnat the 
directory listing includes the date. See next example. 


HANDLING FILES 
DIRECTORY (Cont.) 


SPOIRECTORY/TODAY/EXCLUDE? &.RNO¢ x 


Directory DB2:0303:51 
S-NOV-82 13:45 
X¥-RNOs* excluded 

Tiay of S-NOV-982 


OSJANSS.LGIe1 Os OS-NOV-82 08:20 

2O0S51CH4.MEMs 1 goes OS-NOVY-B82 i¢fil 

2O51CH4A. MEMS 2 320, OS-NOV-82 LOI12 

FUT.-MAI¥1 1. OS-NOV-S2 13505 

FRR» CMDS6 1. 95-NOV-B82 13743 

LOG.«LOG#i 2+ OS-NOV-82 13743 

Total of 672./693. blacks in 6. files 
In this example, the user listed all files created the day the 
command was issued but excluded all files with the .RNO file 
type. Note that the filespec argument to /EXCLUDE has a wildcard 


version number. 


Observe also that the exclusion is noted in the 


heading of the directory listing. 


SDIRECTORY/ATTRIBUTES YACHT.SEQ 


SYSESO3*x,SIYACHT.SEQ#1 
CREATEDs 25-SEP-1982 1 
FILE FROTECTION: 
RECORD FORMAT? 

RECORD ATTRIBUTES: 
FILE ATTRIBUTES: 


F 
2232 


SEQUENTIAL 
OB.ie tay 


TLE ORGANIZATION: 
KEVISEDS- 25-NOVeLoeS 
CRWED*sRWEDsRWEDs RI 

VARTABLE 

CARRTAGE RETURN 


ALLOUCATION= 


This example 
DIRECTORY. 
full display 


shows the display from the /ATTRIBUTES qualifier 


Attributes 


EXTENT 


can 


be 


QUANTITY=0 


to 
displayed for any file, but the 


has meaning only for RMS-11 files. 


SOIR ¥«TSKs 


DR 
OF 


Tirectory 
2O-NOV-Be 


CLOCK. TSK#3 
F.TSKs 1 
G.TSKy1 
TICTAC.TSKI4 
TRER,.TSK31 


Totel of 8%. 


C30L+370I%, TXT 


1:C30373) 
$39 


8, 
4, 
4, 
19, 


54. 


/89. 


blocks ain 


Loe a oe a a 


ae 


15-GCT-S2 OG8755 
SS-SEP-G2 1237230 
25-SEP-82 121330 
OL-O07-82 12107 
SS-SEF-82 L2t31 
files 


HANDLING FILES 


DIRECTORY (Cont.) 


Directory DRLItC301+370]) 
2O0-NOV-82 09239 


FRONT. TXT3 1 
EDITNEWS.TXT#12 
OZY.TXT#3 

TEXT. TXT#1 

NEW. TXT? 1 
AWARE. TXT#2 
IZZY.TXT#10 


16-JUN~-82 11:23 
L1i-SEF-82 10350 
11-SEP-82 10350 
LI-SEF-82 10350 
L 27-JUL-82 14336 
27-JUL-82 13348 
22-MAY-B2 13342 


hd 


horn Or hr bi 
“*.* * one one 
— 
+ 


Total of 184./205. blocks in 7. files 


Grand total of 273./294. blocks in 12. files in 2. directories 


In this example, a user with the default UFD of [303,5] requested 
directory information on files in two directories. The default 
UFD was applied to the first files named, the *.TSK files; these 


were listed first in the display. The second set of files 
displayed, the *.TXT files, were from UFD [301,370], which was 
explicitly specified in the command. Note the locked file. 


Compare this example with the next one. 


“DIR C301*/3703%.TXTs «TSK 


Directors [B1:0301+370] 

20-NOV-82 07746 
Lé~JUN-SS Tiss 
11-SEF-82 10150 
11-SEP-82 10:50 
LI-SEF-82 107350 

Lo 27-JUL-82 14:36 
27~-JUL-82 13348 
22-MAY-82 14°42 


FRONTS TAT EL 
EDITNEWS.TXT#i2 
OZY.TAT#3 

TEXT. TXT#1 

NEW. TXT#F4 
AWARE.TXT#2 
TZZY,TXTs10 


7 + Che cH 
_ * 
+ 


ee Pee Po ht Po Po Gd 


ADVENT. TSK#1 oil. C 23-MAY-82 14212 
QUNGEON.TSK$2 42. C 21-AUG-82 09308 
FONG. TSKs2 ae C 23-MAY-82 14215 
YCLOCK.TSKi6 ‘ C O8-JUL-B82 12317 
STAR. TSK#2 O02, C 13-JUL-82 09307 
TICTAC.TSKSS 17. C O1-AUG-82 11331 
VTICHS.TSKF12 26. C O6-NOV-82 15°39 
XULOCK.TSK3S 9, C OG3-JUN-82 146248 
LIFE.TSK#19 4. C OS-APR-82 132328 


Totel of 758./780. blocks im 16. files 


The command in this example is quite similar to the command used 
in the previous one, but notice the difference in results. The 
same user, with default directory [303,5], issued the command but 
this time the UFD [301,370] was specified first, for the *.TXT 
files. Even though no UFD was specified for the *.TSK files, 
these files were also listed from UFD [301,370] -- not from 
{303,5]. This demonstrates that specifying a UFD in a DIRECTORY 
command resets the default UFD for the rest of the command or 
until another UFD is specified. 


HANDLING FILES 


DELETE 


Notes 


For more information on directories in general, see Chapter 3 of 
the RSX-11M/M-PLUS Utilities Manual for more information. 


The full format for directory listings may include two dates. 
The first is the creation date of the file. The second date 
indicates the last time the file was opened by the system or a 
task, such as for backup. The decimal number in parentheses 
following the second date is the number of times the file has 
been opened in this fashion. 


Your directory is a file that you own, but which is kept in UFD 
{0,0] on the same volume as your UFD. In UFD [0,0] you will find 
the Master File Directory (MFD), which is a file named 
000000.DIR. The MFD is the directory for UFD [0,0]. All UFDs on 
the volume appear in this directory in the same form. The 
directory for UFD [303,5] is called 303005.DIR; the directory 
for UFD [7,40] is 007040.DIR, and so forth. 


These directory files have file protection like all other files. 
The protection is for the directory file, not for files in the 
directory. Since the directory is a file, READ access is the 
right to list the directory, and WRITE access is the right to 
create files in the directory. If you do not have EXTEND access 
to a directory, you may be denied the right to create more than a 
certain number of files in the directory. DELETE access means 
the right to delete the directory file. If you delete a 
directory file, you must use the VFY utility to recover files 
from the directory. See Chapter 9 of the RSX-11M/M-PLUS 
Utilities Manual. 


4.3.2 DELETE 


DELETE deletes specified files and releases the storage space the 
files occupy. 


Format 


DELETE([/qualifier] 
File(s)? filespec[s] 


DELETE[/qualifier] filespec{[s] 
Command Qualifiers 


/LOG 

/QUERY 

/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH: dd-mmm-yy 

/ SINCE: dd-mmm-yy/ THROUGH :dd-mmm-yyy 
/ TODAY 

/ EXCLUDE: filespec 


HANDLING FILES 


DELETE (Cont.) 


Parameter 

filespec([s] 
Specifies the file or files to be deleted. 
You must supply the name, type, and version number fields of the 
filespecs of the files you wish to delete. Device and UFD fields 
default to your current device and UFD. You can use wildcards in 
any filespec field except the device field. You need not supply 
a file type to delete a file with a null file type. 


You can only delete files to which you have DELETE access. 


To name more than one file for deletion, separate their filespecs 
with commas. 


Command Qualifiers 
/ LOG 


Specifies that a list of the files deleted be displayed on your 
terminal. 


/QUERY 


Specifies that you wish to decide which files should be deleted 
on an individual basis. Each file that is specified in the 
command is named. You may enter one of four characters: 


Y - Deletes file named and goes on to next file. 
N - Does not delete file named and goes on to next file. 
G - (Go) Deletes the file and goes on to delete all other 
files specified. 
Q - (Quit) Does not delete the file and exits the task. 
No more files are deleted. 
Remember that you can specify files by default or wildcard. See 
examples. If you do not specify a version number, /QUERY is the 


default. See tne examples. 
/ DATE: dd-mmm-yy 


The /DATE qualifier specifies that you wish the DELETE command to 
affect only files created on the date given. 


/SINCE:dd-mmm-yy 


The /SINCE qualifier specifies that you wish the DELETE command 
to affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the DELETE command 
to affect only files created on or before the date given. 


HANDLING FILES 


DELETE (Cont.) 


/SINCE:dd-mmm-yy/ THROUGH: dd-mmm-yy 


The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish the DELETE command to affect only files created 
within that range. 


The /TODAY qualifier specifies that you wish the DELETE command 
to affect only files created on the same day the command is being 
issued. 


/ EXCLUDE: filespec 


The /EXCLUDE qualifier specifies that you wish the DELETE command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 


eee eee i ee ee 


Examples 


PDELETE 
File(s)? xk. DAT? 


This example deletes all versions of all files of the type .DAT. 


2DELETE FILE.FILei+s 33+ .TXT#S 


This example deletes versions 1 and 3 of FILE.FIL, and version 5 
of FILE.TXT. Note that no filename or type is specified for 
version 3, and no name for .TXT;5. 


STELETE/QUERY 
File(s)? *. TMF sx 


Tlelete file PRLiC 2032S 10GRE. TMF CY/N/G/QI? 7 
Tielete file QBIIESO3,SITROLL. TMF 1 CY/N/G/QI? ¥ 
Delete file DBI CS03,S510kC. TMF si CY/N/G/Q]? ¥ 
Telete file DRL: CS0S3sSIELF.TMP sd CY/N/G/QI? N 
elete file DBIS£S03+SIHORBIT. THRE i CY/N/G/Q]7 N 
Telete file DPRLICSO3+SISNIPE. TMF? 1 CY/N/G/QI? G 


Tne followings files have been deleted? 
PRLS C303 °,SISNIPE. TMF SE 1 
DBL? C3OS3,SISNOPE. TMF 32 


In this example, the user specified all files having the type 
-TMP in the DELETE command. Three files were deleted at the 
user's choice, and two were retained. The user then directed 
that all remaining files with the type .TMP be deleted. There 
were two more files, which were deleted and listed. 


HANDLING FILES 


PURGE 


SDELETE &.00C 


ielete file DROS CZ0SesSIWITCR. DOC32 CY/N/G/Q]7F ¥ 
Nelete file DRO LSGS+;SIDRY MGC +4 CY AN/G/OIT 
tielete file WRC CSOS+sS IP AVYCHECK .0OCr1 CY/N/G/Q007 ¥ 
lelete file PROC SOS eS ILOANING. DOCe? CY/N/G/QI7 Y¥ 
Delete file PROS CSOS;SILGADING, 0OC34 CY/N/G/QIF Y 
Delete file PROS CSOS,;SILOARING. bOCES C¥F/N/G/QI17 Y 
ielete file VROICSOS3,SILOADING. NOC Ss CY/N/G/Q17 WN 


In this example, the user specified the file type .DOC and a 
wildcard for the file name. Because no version number was given, 
the DELETE command defaulted to the /QUERY qualifier, enabling 
the user to choose which files to delete. 


SDELETE/LOG *.LSTsx 


The following files nave peen deleted? 
QBL:C303rSIRANGER.LST#1 
DRItC393°;SITONTO.LSTI1 
DBLISCSOS3,SIRELOLLSTI1 
DRLIC3SO3+,SISILVER.LLSTII 

DBL? CS032;S5ISCOUT.LETF1 
DBLiCSOZ-;SIHORNET.LST #1 
DBLIiC303+SIKATO.LST$1 


In this example, the user specified all files with the type .LST 
in the DELETE command and asked that they be listed as they are 
deleted. 

Notes 
You must have DELETE access to delete a file. 
If you wish to delete using wildcards, it is wise to get a 
directory listing using the same filespecs you plan to delete. 
In this way, you can be sure you are not deleting more files than 
you intend to delete. 
Remember that under the default file protection on RSX-11M/M-PLUS 
systems, you have DELETE access to your own files and all files 
in directories with the same group number. 


See Chapter 9 for DELETE commands directed to the queue manager. 


4.3.3 PURGE 


PURGE deletes all but the latest versions of files, and releases the 
Storage space the deleted files occupy. 


Format 


PURGE[/qualifier[s] ] 
File(s)? filespec[s] 


PURGE[/qualifier[s]] filespec[s] 


HANDLING FILES 


PURGE (Cont.) 


Command Qualifiers 


/ [NO] LOG 

/KEEP:n 

/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 
/ TODAY 

/ EXCLUDE: filespec 


Parameter 

filespec[s] 
Specifies the file group or file groups to be purged. 
Because of the nature of the command, you cannot include a 
version number in the filespec. Multiple filespecs must be 
separated by commas. Wildcards can be substituted for UFD, name, 
and type fields. 
You can purge any files to which you have DELETE access. 

Command Qualifiers 


/ [NO] LOG 


Specifies that the files deleted by PURGE be listed on your 
terminal. The default is /NOLOG. 


/KEEP:n 

Specifies that the n latest versions of a file be retained. 

If you do not use this qualifier, all versions but the most 
recent of a given file are deleted. That is, the default form of 
the command includes the qualifier /KEEP:l1. With the qualifier 
explicitly stated, all but the n highest numbered versions are 
deleted. PURGE assumes that version numbers are in numerical 
sequence and without missing numbers. See example. 


If more than one filespec is given with the /KEEP qualifier, all 
but tne latest n versions of all files listed are deleted. 


/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the PURGE command to 
affect only files created on the date given. 


/ SINCE: dd-mmm-yy 


The /SINCE qualifier specifies that you wish the PURGE command to 
affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the PURGE command 
to affect only files created on or before the date given. 


HANDLING FILES 


PURGE (Cont.) 


/SINCE:dd-mmm-yy/ THROUGH :dd-mmm-yy 


The /SINCE and /THROUGH qualifiers can be combined to. specify 


that you wish the PURGE command to affect only files created 
within that range. 


/ TODAY 


The /TODAY qualifier specifies that you wish the PURGE command to 
affect only files created on the same day the command is being 
issued. 


/EXCLUDE: filespec 


The /EXCLUDE qualifier specifies that you wish the PURGE command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly, or as "*" wildcard. 


Examples 


* PURGE 
File(s)? TEMPER. TSK 


In this example, all versions of TEMPER.TSK but the latest are 
deleted. 


SDIRECTORY ASEIC. TNL ks ELPASO. TEKS 


Itirectory DRIiC304:5) 
PO-NOYV-82 L344 


ASDIC.TMIs1 1. 2G-NOV-B2 137541 
ASHIC.TMis2 1 2O-NOV-G2 13241 
ASHIC.TMiss i. 20-NOV-32 13341 
ASHIC.TM1:4 O. 2O-NOVU-82 1354) 
ASDUIC.TM1FS 1. 2O-NOV-82 13342 
ELFASO.TEX?1 i. 20-NOV-82 15:42 
ELFASO.TEXs2 1. 20-NOV-B2 13:42 
ELFASO.,TEX?3 1. 29-NOV-82 13:42 
ELFASO.TEX#5 Le 2O0-NOV-82 13743 
ELFASO,TEX?4 1. 2O0-NOV-82 13543 


Total of 9.745. blocks in 16. files 


*PURGE/LOG/KEEF?3 ASTIC. TMi 


The following files heave been deleted? 
DBLItCSO0SsSIASDIC.TM1Iis1 
DBI CSOSsSIASHIC,. TML:2 


HANDLING FILES 
COPY 


*PURGE/LOG/KEEF!3 ELFASO.TEX 


Tne followings files nave been deleted? 
DRL? C303*/57ELFASO. TEX 1 
DRL:CSO3;SIELFASO.TEK#2 
DRL? CS03-,;S3EL FASO. TEX? 3 


STIRECTORY ASDIC.TMiF#ks ELPASO.TEXs & 
Directory DRIICZO2,57 
2O-NOV-82 13346 


ASDIC.TM1:3 1. 20-NOV-82 13341 
ASHIC.TM1F4 O. 2O-NOV-G2 13541 
ASDIC.TM195 1. 2O-NOV-B2 13242 
ELFASO.TEXs#3 le 2SO-NOV-B2 13:48 
ELFASO.TEXs6 1. 2O0-NOV-82 137343 


Total of 4.720. blocks in 5S. files 


In this example, the user started with two sets of five files. 
The five files named ASDIC.TMl have version numbers in order. 
The five files named ELPASO.TEX are numbered 1,2,3,5,6. The user 
issued a PURGE command with the qualifier /KEEP:3. Versions 4, 
5, and 6 of ASDIC.TM1 were kept, but only versions 5 and 6 of 
ELPASO.TEX. This is because the /KEEP:3 qualifier does not save 
the three highest numbered files, but rather the highest numbered 
file and the next two lower numbered files of the same name in 
numerical sequence. If there had been a file ELPASO.TEX;4, it 
would have been saved. Since there was none, the PURGE command 
task exited, its work done. 


Notes 


You can purge any file to which you have DELETE access. 


4.3.4 COPY 
COPY copies files. 


COPY creates a sequential file copy of one or more sequential files, 
or of records with either indexed or relative file organization. 


Format 
COPY[/qualifier[s] ] 
From? infile[s] [/qualifier] 


To? outfile 


coPpY[/qualifier[s]] infile[s] [/qualifier] outfile 


HANDLING FILES 
COPY (Cont.) 


Command Qualifiers 


/ [NO] CONTIGUOUS 

/ REPLACE 

/OWN 

/BLOCKSIZE:n 

/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/ THROUGH :dd-mmm-yy 
/ TODAY 

/ EXCLUDE: filespec 


Parameters 

infile[s] 
Specifies the input file or files to be copied. 
You must have READ access to a file to copy it. 


Multiple filespecs, separated by commas, are accepted. If you 
specify multiple input files, they will be concatenated in a 
Single output file in the order that you specify them. 


outfile 


Specifies a single output file to which the input file or files 
is copied. 


You must have WRITE access to the UFD to which you wish to send a 
copy. Under the default protection, you have WRITE access to 
your UFD and to all UFDs with the same group number. 


You can change the name, type, and version number of the file 
when you enter this parameter. Wildcards in the place of the 
name and the type leave the name and type unchanged. If you’ use 
a wildcard in either of these fields, you must use a wildcard in 
both. 


The output file can be created by COPY. The output file need not 
exist when you issue the command. If a file of the same name and 
type already exists, then the file you create has aversion 
number one higher than the highest existing version. If you 
specify a version number for the output file field, then a file 
of that version number is’ created. If such a file already 
exists, the operation fails. 


Wildcards are acceptable for output files if the destination is 
another UFD. If you have multiple input files and use wildcards 
for the output file, you create multiple output files, each with 
the name and type of the corresponding input file. 


You can send copies to devices as well as to UFDs. See examples. 


em mm ke om weiat aes 


You can also use the COPY command to create multiple copies o 
the same file with the same or different names. 


HANDLING FILES 


COPY (Cont.) 


Command Qualifiers 

/ {NO] CONTIGUOUS 
Specifies that the output file must be contiguous. If this 
qualifier is not used, then only files that are already 
contiguous remain contiguous when copied. 
The default is /NOCONTIGUOUS. 

/REPLACE 
If the output file. has the same name, type, and version number as 
an already existing file at the destination, the first file is 


deleted and the file you have sent replaces it. The name, type 
and version number stay as they were. 


/OWN 
Changes the ownership of the file being copied from the source 
UIC to the destination UIC. After execution, both UICS own 
copies. If you do not specify /OWN, the original UIC owns’ both 
copies. If you are copying from another directory to your own, 
use this qualifier. 

/BLOCKSIZE:n 


Defines block size for magnetic tape. n can be octal or decimal; 
if decimal, you terminate n with a decimal point. For example: 


/BLOCKSIZE: 25. 
/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the COPY command to 
affect only files created on the date given. 


/SINCE:dd-mmm-yy 


The /SINCE qualifier specifies that you wish the COPY command to 
affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the COPY command 
to affect only files created on or before the date given. 


/SINCE:dd-mmm-yy/THROUGH: dd-mmm-yy 
The /SINCE and /THROUGH qualifiers can be combined to specify 


that you wish the COPY command to affect only files created 
within that range. 


/ TODAY 
The /TODAY qualifier specifies that you wish the COPY command to 


affect only files created on the same day the command is being 
issued. 


HANDLING FILES 
COPY (Cont.) 


/ EXCLUDE: filespec 


The /EXCLUDE qualifier specifies that you wish the COPY command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 


Examples 


~COFY 
From? C393,4] TSKBLD. CME 
Toft TSRELO.CKS 


This example copies TSKBLD.CMD from [303,4] to the current UFD 
and device. The file is still owned by the source UIC. 


>COFY *.BAS DDK1: 
This example copies all files with the file type .BAS from the 
current device and UFD to the same UFD on the volume mounted on 
device DK1:. 

=COFY/OWN TSRBLO.CMO 0303-4] BLDFIL. CMO 


This example copies TSKBLD.CMD from the current UFD and device to 
[303,4], assigns ownership to the destination UIC, and also 


ehannac tte nama tn BERFPTYT CMD 
cS mame co SEDFLELELL 
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=COFY/CONTIGUOUS LITTER. DAT #.x 
This example creates a new version of the file LITTER.DAT. The 
new version is contiguous. 

“COPY OLDL.FILsOLM2.F CL 

To? NEW.ONE 
This example copies two previously existing files into one new 
file. 

=COFY CHARLA.TMF TT412 
This example prints a copy of CHARLA.DMP on TT41:. This is a 
convenient means of sending messages longer than one line. If 
the terminal is busy at the time you send the copy, the copy is 
held until the terminal is clear and then sent. 


sCOPY FLY.TXT SPIDER. TXT 


This example creates the file SPIDER.TXT with the same contents 
as FLY.TXT, both on the current device and UFD. 


Notes 


4.3.5 


HANDLING FILES 


RENAME 


C is the short form of copy. 


COPY does not affect file organization. If you wish to change 
file organization, use the CONVERT command, Section 4.3.6. 


Usually, READ access is much broader than WRITE access. Under 
the default protection setup, your READ access covers the whole 
system, but your WRITE access is limited to other UFDs with the 
same group number. Thus, you can copy from many places that you 
cannot copy to. 


Also, when you copy a file, you do not copy its protection code. 
Your copy has the default protection code. Use SET PROTECTION if 
you want to change the protection code of the copy. 


Note that you can change the name, type, and version number of a 
Single file as you copy it. 


RENAME 


RENAME changes the name, type, or version number of an existing file. 


Forma 


t 


RENAME[/qualifier[s] ] 

Old file name? infile 

New file name? outfile 
RENAME[/qualifier[s]] infile outfile 


Command Qualifiers 


/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH :dd-mmm-yy 

/ SINCE: dd-mmm-yy/THROUGH :dd-mmm-yyy 
/ TODAY 

/ EXCLUDE: filespec 


Parameters 


infil 


e 
Specifies the file to be renamed. 


You may give a wildcard for either the file name or the file 
type, or both. If you use a wildcard in these fields, you must 
supply an entry in the version number field. This may be a 
wildcard. 


If you give a wildcard for version number, all versions’ retain 
their old version numbers. If no version number is supplied, 
only the highest version of the named file is renamed. It has 
the same version number as the old file. If other files having 
the new name exist, then you receive an error message. 


HANDLING FILES 


RENAME (Cont.) 


outfile 
Specifies the new name for the file. 


Wildcards leave that portion of the filespec the same as before. 
No wildcard is needed for the version number. 


Command Qualifiers 
/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the RENAME command to 
affect only files created on the date given. 


/SINCE:dd-mmm-yy 


The /SINCE qualifier specifies that you wish the RENAME command 
to affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the RENAME command 
to affect only files created on or before the date given. 


/ SINCE: dd-mmm-yy/ THROUGH: dd-mmm-yy 


The /SINCE and /THROUGH qualifiers can be combined to _ specify 
that you wish the RENAME command to affect only files created 
within that range. 


/ TODAY 


The /TODAY qualifier specifies that you wish the RENAME command 
to affect only files created on the same day the command is being 
issued. 


/EXCLUDE:filespec 


The /EXCLUDE qualifier specifies that you wish the RENAME command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 


Examples 


RENAME 
Old file name? INTRO.TXT 
New file mame? APPENDIX. TXT 


In this example, the most recent version of INTRO.TXT becomes 
APPENDIX.TXT;1. 


RENAME IZZY.TXT$4 FIZZY.x 


L - ee 


In this example, IZZY. 
of IZZY.TXT are not affected. 


HANDLING FILES 


CONVERT 


“RENAME AMA, TOC#4 ¥.KFIL 


In this example, AMA.DOC;4 becomes AMA.DOC;11. 


>RENAME MAIN. TSKSX EXTRA. TSK 


In this example, all files named MAIN.TSK are renamed EXTRA.TSK. 
The version numbers remain the same, regardless of sequence and 
order of file creation. 


>RENAME MAIN. TSK#X SUB.X 
In this example, all versions of MAIN.TSK are renamed SUB.TSK. 
Versions are in the order of creation, with numbers unchanged. 
REN EXHAUST. &3% REFRESH, * 
In this example, all files named EXHAUST of whatever type are 
renamed REFRESH. Their file types remain the same. Note that a 
wildcard is given for the input file type. This makes an entry 
in the version number field mandatory. 
Notes 


You cannot rename files across devices. 


Using wildcards is also tricky. Experiment before committing 
yourself. 


4.3.6 CONVERT 


The CONVERT command invokes the RMSCNV utility, which moves’ records 
fom one file to another. RMSCNV reads records from an input file and 
writes them to an output file. The action of RMSCNV depends on_ the 
organization -- sequential, relative, or indexed -- of the two files, 
and on the qualifiers you include in the CONVERT command. See the 
RMS-11 documentation supplied with your system for more information. 


Format 
CONVERT [/qualifier[s] ] 
Input file? infilespec 


Output file? outfilespec 


CONVERT [/qualifier[s]] infilespec outfilespec 


HANDLING FILES 
CONVERT (Cont.) 


Command Qualifiers 


/ [NO] APPEND 

/BLOCK SIZE:n 

/{NO] FIXED CONTROL 
/{NO] IDENTIFICATION 
/ INDEXED 

/KEY [in] 

/({NO]LOG FILE[:filespec] 
/(NO]MASS_ INSERT 

/ MERGE 
/(NO]PAD[: [#] arg] 
/RELATIVE 

/ [NO] REPLACE 

/ SEQUENTIAL 

/ [NO] TRUNCATE 


Parameters 
infile 


Specifies the file that is the source of records to be written to 
the output file. CONVERT reads input records sequentially, 
regardless of the organization of the input file. No wildcards 
permitted. 


outfile 


:¢ file that is to receive the records from the input 
file. The default file organization for the output file is 
sequential. If the output file is not sequential, use the 
/RELATIVE or /INDEXED qualifier to indicate the organization. If 
the output file is to be sequential, CONVERT can create the file; 
it need not exist prior to your entering the CONVERT command. 
CONVERT cannot create indexed or relative files; these must have 
been created prior to your entering the CONVERT command. See the 
RMS documentation supplied with your. system. No wildcards 
permitted. 


Command Qualifiers 
/ {NO] APPEND 


Specifies that you wish RMSCNV to append records to the end of an 
existing sequential file. If the output file is not sequential, 
RMSCNV ignores the qualifier. You cannot use both /APPEND and 
/REPLACE in the same command line. 


The default is /NOAPPEND, but the action taken depends on the 
presence of the /REPLACE qualifier in the command line. If you 
specified /REPLACE, RMSCNV performs the replace operation. Tf 
you did not specify /REPLACE, RMSCNV creates the next higher 
version of the file. 


This qualifier is the equivalent of the /AP switch in an RMSCNV 
command line. 


HANDLING FILES 


CONVERT (Cont.) 


/BLOCK SIZEin 


Specifies the physical block size of an output file being created 
on magnetic tape. n can be from 18 through 8192 characters. 
RMSCNV rounds this value up to the next multiple of 4. If you do 
not specify this qualifier, the default tape block size is 512 
characters. 


This qualifier is the equivaient of the /BL switch in an RMSCNV 
command line. 


/{NO] FIXED CONTROL 


The /FIXED CONTROL qualifier directs RMSCNV to handle 
variable-with-fixed-control (VFC) format records in either the 
input file or the output file. If the fixed-control area of the 
input file and the output file are the same size, RMSCNV performs 
a straightforward copy. See the RMS-11 documentation supplied 
with your system for information on how RMSCNV handles other 
combinations. If you include this qualifier and neither file 
specifies VFC records, RMSCNV terminates. 


This qualifier is the equivalent of the /WF switch in an RMSCNV 
command line. 


The default is /NOFIXED CONTROL. This means that if one of the 
named files contains VFC records, the fixed-control area of each 
record is ignored. That is, if the input file includes VFC 
records and the output file does not, only the variable portion 
of each record is written to the output file; if the output file 
includes VFC records and the input file does not, data is written 
only into the variable portion of each output record. 


/ (NO] IDENTIFICATION 


Requests that RMSCNV print its current version number and _ patch 
level on your terminal. See the RMSCNV documentation for more 
information. 


This qualifier is the equivalent of the /ID switch in an RMSCNV 
command line. 


The default is /NOIDENTIFICATION. 
/ INDEXED 


The /INDEXED qualifier informs RMSCNV that the output is of 
indexed organization. Regardless of their organization, all 
input files are read sequentially. 


RMSCNV reads each record from the input file, then applies the 
output file's record format, that is, key placement within the 
record, to the data. If you do not specify the /KEY qualifier 
with a value, the key of reference is the primary key; 
otherwise, it is the key you specify. 


HANDLING FILES 


CONVERT (Cont.) 


This qualifier is the equivalent of the /FO:IDX switch in an 
RMSCNV command line. 


See the RMSCNV documentation for more information. 


/KEY[:n] 


Indicates the key that establishes the order in which records are 
read sequentially from an indexed input file and written to the 
output file. n can be from 0 through 9. The default is n=0 and 
indicates the primary key; n=l is the first alternate key; n=9 
is the ninth alternate key. 

This qualifier is the equivalent of the /KR switch in an RMSCNV 
command line. 


/ [NO] LOG[:filespec] 


Directs RMSCNV to summarize processing in a log. If you do not 
include a filespec, the log appears on your terminal. If you 
name a file, that file will be created and written to by RMSCNV. 
The log includes the following elements: 


1. The command string in RMSCNV format. This will not be _ the 
same as DCL format. 


2. Copies of all error messages produced during execution. 

3. An indication of any duplicate-key problems. If the log is 
appearing on the terminal, the indication consists only of 
the following message: 

SOME DUPLICATE RECORDS NOT WRITTEN 
If the log is being written to a file, RMSCNV supplies’ the 
indicator DUP RCD= followed by the first 72 characters of the 


record that could not be written. 


This qualifier is the equivalent of the /SL switch in an RMSCNV 
command line. 


The default is /NOLOG meaning that only normal error messages 
appear on your terminal. 


/{NO]MASS_INSERT 


Directs RMSCNV to activate the RMS-1l mass insert I/0 technique 
and then use sequential put operations to insert records into the 
output file. 


This is the equivalent of the /MA switch in an RMSCNV- command 
line. 


The default for nonsequential file organization is 
/NOMASS_ INSERT. See the RMS-11 documentation supplied with your 
system for further information. 


HANDLING FILES 


CONVERT (Cont.) 


/ MERGE 


Directs RMSCNV to copy records from the input file into the 
output file. Both files must be of the same organization. 


/ [NO] PAD[: [#] arg] 


Directs RMSCNV to pad records read from the input file to the 
output file's record length before writing them to the file. If 
you specify the qualifier without an argument, the pad character 
is null. If you do not include the number sign (#), the argument 
can be any printing ASCII character except: the number. sign, 
question mark (?), or commercial-at sign (@). If you include the 
number sign (#), n can be an octal number from 0 through 377, 
representing the full ASCII character set. This enables you to 
use the three excluded characters as pad characters by specifying 
43 for #, 77 for ?, and 100 for @. 


Use this qualifier only when the output file specifies 
fixed-length records. 


This qualifier is the equivalent of the /PD switch in an RMSCNV 
command line. 


/RELATIVE 


The /RELATIVE qualifier informs RMSCNV that the output file is of 
relative organization. Regardless of their organization, all 
input files are read sequentially. 


The /RELATIVE qualifier is the equivalent of the /FO:REL switch 
in an RMSCNV command line. 


RMSCNV reads records from the input file and writes them into 
Successive record cells of the output file, beginning with cell 
l. If RMSCNV encounters a cell containing a _ record, it 
terminates with an error message. All records written to that 
point are in the output file. You should examine the two files 
to determine how far the processing went. 


See the RMS-11 documentation supplied with your system for more 
information. 


/ [NO] REPLACE 


The /REPLACE qualifier directs RMSCNV to supersede an existing 
sequential file. RMSCNV replaces a file in the output account 
with the same file name, type, and version number. You cannot 
use /REPLACE and /APPEND in the same command line. 


The /REPLACE qualifier is the equivalent of /SU in an RMSCNV 
command line. 


The default is /NOREPLACE, but the default action depends on 
whether the command line includes an /APPEND or not. If you 
specify /APPEND, RMSCNV performs the append operation. If you do 
not specify /APPEND, RMSCNV creates the next higher version of 
the file. 


HANDLING FILES 


CONVERT (Cont.) 


/SEQUENTIAL 


The /SEQUENTIAL qualifier informs RMSCNV that the output file is 
of sequential organization. Regardless of their organization, 
all input files are read sequentially. The default output file 
organization for RMSCNV is sequential. 


This qualifier is the equivalent of the /FO:SEQ switch in an 
RMSCNV command line. 


If you do not specify either the /APPEND or /REPLACE qualifier, 
and the output file is sequential, the output file need not exist 
before you issue the CONVERT command. 


If the output file does not exist, RMSCNV creates an output file 
with the record attributes of the input file. RMSCNV then reads 
records from the input file and writes them sequentially into the 
new output file. 


If the output file already exists, and the command does not 
include the /APPEND qualifier, RMSCNV creates the next higher 
version of the file. RMSCNV then reads records from the input 
file and writes them sequentially into the new version of the 
output file. 


If the output file exists and you specify the /REPLACE qualifier, 
RMSCNV reads records from the input file and writes them 
sequentially into the output file, starting with the beginning of 
the file. 


If the output file exists and you specify the /APPEND qualifier, 
RMSCNV reads records from the input file and writes them into the 
output file, starting with the record position following the last 
record already in the file. 


/ {NO] TRUNCATE 
Directs RMSCNV to truncate records read from the input file to 
the output file's record length before writing them into the 
Output file. The trailing bytes of the record are truncated. 
The default is /NOTRUNCATE. If you do not specify /TRUNCATE and 
the input records are too long, RMSCNV terminates with the 
following message: 


CON -- Input and output record sizes do not correspond 


Examples 


“CONVERT 
Inrut file? FOO. RAR 
Qutreut filet POOH. BAR 


The output file does not exist. RMSCNV creates the sequential 
file POOH.BAR and copies the records from FOO.BAR into it. 


“CONVERT FOO. BAR POOR. BAR 


This example is the equivalent of the previous one. 


HANDLING FILES 


CONVERT (Cont.) 


SCONVERT/INTEMED GRIZZLY. BAR CROW. SAR 


RMSCNV reads each record of the input file GRIZZLY.BAR 
sequentially and examines the contents of the primary key field, 
which is defined as an attribute of CROW.BAR. RMSCNV- then 
inserts the record into CROW.BAR. 


SCONVERT/RELATIVE/KE 21 SAND. BAR MAX. BAR 


RMSCNV reads the indexed input file SAND.BAR, using the first 
alternate key of the file to establish the sequence of access. 
Then RMSCNV writes the records sequentially into an empty 
relative output file MAX.BAR, starting with record cell l. 


Note that the /RELATIVE qualifier refers to the organization of 
the output file and the /KEY qualifier refers to the organization 
of the input file. 


sCONVERT/APPEND/SEQUENTIAL/KEYi2 RUNNING. BAR CORNER, BAR 


RMSCNV reads the indexed input file RUNNING.BAR, using the second 
alternate key of the file to establish the sequence of access. 
Then RMSCNV appends the records at the end of the existing 
sequential output file CORNER.BAR. 


If the /APPEND qualifier had not been specified, RMSCNV would 
have created the next higher version of CORNER.BAR and written 
the records from RUNNING.BAR into it. 


»CONVERT/RELATIVE/FIXED CONTROL MAMA. BAR FAFA, BAR 


RMSCNV reads fixed-length records from the indexed input file 
MAMA.BAR, using (by default) the primary key of the file to 
establish the sequence of access. The RMSCNV writes the records 
sequentially in a VFC format into the existing relative file 
PAPA.BAR. Record format is an attribute of each file. As each 
record is written, the first bytes become the fixed control area. 


=CONVERT/TRUNCATE/BLOCK_SIZEt11024/APFPEND/KEYS? BRER. BAR 
Outeut file? MM3?iBRER. BECK 


RMSCNV reads the indexed input file BRER.BAR, using the file's 
ninth alternate key to establish the sequence of access. The 
RMSCNV writes the records to magnetic tape, truncating them to 
the output file's record length before adding them to the end of 
the existing file, and formatting the tape blocks to 1024 bytes 
each. 


Notes 


You must have a clear understanding of RMS-11l and the various 
forms of file organization it supports before using the CONVERT 
command. See the RMS-11 documentation supplied with your system 
for further information. 


HANDLING FILES 


TYPE 


Sequential files used with the CONVERT command have been created 
by FCS. 


The CONVERT command replaces some functions of the COPY and MERGE 
commands in the previous release of RSX-11M-PLUS DCL. 


4.4 OTHER FILE-RELATED COMMANDS 


The commands in this section perform varied actions on your files. 
The TYPE command displays files on your terminal. The PRINT command 
prints files on the system line printer. The APPEND, MERGE, and SORT 
commands alter the contents of certain files. The DIFFERENCE command 
displays the differences between two files and the UNLOCK command 
unlocks locked files. 


4.4.1 TYPE 
TYPE prints selected files on your terminal. 
Format 


TYPE[/qualifier[s]] 
File(s)? filespec[s] 


TYPE[ /qual ifier[s!] Filesnec!s]} 
Command Qualifiers 
/DATE:dd-mmm-yy 
/SINCE: dd-mmm-yy 
/ THROUGH: dd-mmm-yy 
/SINCE:dd-mmm-y y/THROUGH: dd-mmm-yy 
/ TODAY 
/ EXCLUDE: filespec 
Parameter 
filespec[s] 
Specifies the file or files to be printed on your terminal. 


You can specify any file to which you have READ access. 


The file name and type must be specified explicitly or with a 
wildcard (*). If no version is specified, the most recent 
version is printed. A wildcard in any field prints every file 
that matches otherwise. Both the * and the % wildcards are 
accepted. 


You can also specify a device and UFD. If you do not, these 
fields default to the current device and UFD. 


Multiple filespecs must be separated by commas. 


HANDLING FILES 


TYPE (Cont.) 


Command Qualifiers 


/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the TYPE command _ to 
affect only files created on the date given. 


/SINCE:dd-mmm-yy 


The /SINCE qualifier specifies that you wish the TYPE command to 
affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the TYPE command 
to affect only files created on or before the date given. 


/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 


The /SINCE and /THROUGH qualifiers can be combined to. specify 
that you wish the TYPE command to affect only files created 
within that range. 


/ TODAY 


The /TODAY qualifier specifies that you wish the TYPE command to 
affect only files created on the same day the command is being 
issued. 


/EXCLUDE:filespec 


The /EXCLUDE qualifier specifies that you wish the TYPE command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 


Examples 


=TYPE 
File(s)? LOGIN.CH2 
+ENABLE QUIET 
slF <CLI> EQ "MCR" SET /UCL=TI?t 
SET TERMINAL LOWER 
ASSIGN DBL? SYO3 
GAZ 


This example prints the file LOGIN.CMD from the current device 
and UFD on your terminal. 


STYP C303,12IL0GIN. CME 
*IF <CLI=> EQ "MCR" ASN DRLt=SY¥i 
«IF <CLI> EQ "TCL" ASSIGN DRI? SYOt 
TYPE LOGIN. TXT 
TYFE A-+A 
SET /DCL=TI? 


This example prints the file LOGIN.CMD from the current device 
and UFD [303,12] on your terminal. 


HANDLING FILES 


PRINT 


=TYPE Ck&ekIK. FILE 
This is the besinning of a file nameo ARTHUR.FIL. 
It does on for several jlines. 


+ 


THIS MARKS THE INITIATION OF A FILE CALLED ALBERT.LFIL, 

IT TOO CONTINUES AT SOME LENGTH. 

Now comes 32 file thet starts like this celled Z.FIL. 

And some mare, 

At last, we reach the beginnings of a@ file nmamed FILLIE.FIL. 
Adsin some more text and then 


+ 


The last two lines of FILLIE.FIL. 
2222222222222 7222222222 27272222 


This example prints on your terminal all versions of all files 
having the type .FIL located on the current device. 


Notes 


In general, RSX-l11M/M-PLUS documentation uses the term "print" to 
refer to any output sent to a terminal and "type" to refer to any 
user input from a terminal. The name of the TYPE command is an 
exception to this rule. 


If you are typing multiple files, the CTRL/O feature works in a 
slightly different fashion. When you enter a CTRL/O, output is 
discarded until you type another CTRL/O or until the beginning of 
the next file is reached, whereupon output is sent to your 
terminal again. This leaves you free to use CTRL/O on a 
file-by-file basis. 


You can type any file, but normally only ASCII text files are 
readable. 


4.4.2 PRINT 


PRINT queves files for printing on a line printer. It can also be 
used to queue jobs for other output devices. PRINT defines a QMG 
print job. 


Format 
NT[{/qualifierjsjj 
e(S) filespec[/qualifier[s]][, filespec[s]] 


R 
i 


i 
1 


ty ry 


PRINT[/qualifier[s]] filespec[/qualifier[s]][, filespec[s] ] 


HANDLING FILES 


PRINT (Cont.) 


Command Qualifiers File Qualifiers 
/ [NO] DELETE / [NO] DELETE 
/COPIES:n /COPIES:n 
-/{NO] TRANSFER {NO} TRANSFER 
/DEVICE:ddnn: 

/ {NO] HOLD 


/JOB_COUNT:n 

/{NO]JOB PAGE 

/QUEUE: queuename 

/ [NO] UPPERCASE 

/ [NO] LOWERCASE 

/{NO]WIDE 

/PAGE COUNT:n 

/NAME: jobname 

/PRIORITY:n 

/FORMS:n 

/LENGTH:n 

/(NO] RESTART 

/{NO]FLAG PAGE 

/AFTER: (dd-mmm-yy hh:mm) 
(mn/dd/yy hh:mm) 

/[NO]WIDE 


Parameter 

filespec[s] 
Specifies the file or files to be printed on the line printer. 
Multiple filespecs must be separated by commas. 


The * can be used in UFD, name, type, and version number fields, 
but only to stand for the entire field. Wildcarding of the form 
L*.TXT is not accepted by PRINT, nor is the % wildcard accepted. 


If your filespec includes no file type, the default file type is 
-LST. 


Command Qualifiers 
/ [NO] DELETE 


Specifies that files be deleted or not deleted from the directory 
after they are printed. The default is /NODELETE. 


The /{NO]DELETE qualifier to the filespec can be used to override 
this qualifier for a given file in a list of filespecs. 


/COPIES:n 


Specifies the number of copies to be printed. The default is 
/COPIES:1. If your PRINT command includes this qualifier and 
specifies more than one file, the resulting QMG print job 
consists of the specified number of copies of the first file 
named, followed by that many copies of the second file, and _ so 
on. If you wish to print multiple copies of files by sets, use 
the /JOB COUNT qualifier. See the examples. 


HANDLING FILES 


PRINT (Cont.) 


The /COPIES:n qualifier to the filespec can be used to override 
this qualifier for a given file in a list of filespecs. 


/DEVICE:ddnn: 


The /DEVICE qualifier specifies that you want the file printed on 
a particular device. 


/ [NO] HOLD 


The /HOLD qualifier specifies that you wish the QMG print job to 
be held in its queve until you release it. See the RELEASE/JOB 
or RELEASE/ENTRY commands in Chapter 9, or the RSX-11M/M-PLUS 
Batch and Queue Operations Manual. The default is /NOHOLD. 


/JOB_COUNT:n 


Specifies the number of sets of files you wish printed. The 
default is /JOB COUNT:1. If your PRINT command includes this 
qualifier and specifies more than one file, the resulting QMG 
print job consists of a set consisting of the files named in 
order, followed by another set, and so on. If you wish to print 
multiple copies of one or more files, but not in sets, use the 
/COPIES qualifier. See examples. 


/{NO]JOB_PAGE 


Specifies whether you wish a job flag page printed at the 
beginning of the QMG print job. The default is /JOB PAGE. Use 
/NOJOB PAGE when you are printing on special forms, or otherwise 
do not wish to include a job flag page. See the /[NO]FLAG PAGE 
qualifier for controlling file flag pages. Figure 4-2 shows’ the 
difference between job flag pages and file flag pages. 


/ QUEUE: queuename 


Specifies the name of the print queue in which the job is to be 
placed. The default is the PRINT queue. 


/ [NO] UPPERCASE 


Specifies that the print job can be sent to a line printer 


without the lowercase character set. The defauit is /UPPERCASE. 


HANDLING FILES 


[7,188] IZ2¥ = NO PAGE LIMIT 25-JAN@82 
FORM #@ » NORMAL HARDWARE FORMS 25=J4NeS2 
NO IMPLIED FORM FEED 25eJANo82 
DearlF, saB] IZZY aTXTGS SSeJanes2 
a 
TT EEEEEEEEEE RRRRRRRR SS9$38838 
TT EEEEEEEEEE  RRRRRRAR SSssssss 
143 RR RR ss 
EE RR RR 3s 
EE RR RR 88 
€& RR RR 88 
EEEEEEEE RRRRRRAR S$$ssss 
EEEEEEEE RRRRRRAR SSSSSS 
€E RR ORR $s 
EE RR RR ss 
EE RR RR $s 
EE RR RR 8s 
EEEEEEEEEE RR RR S8SS838S35 
EEEEEEEEEE RR RR sssssss¢ 
YY 
YY 
YY 
(7,100) 122¥ = NO PAGE LIMIT 25=JAN@B2 
FORM #2 © NORMAL HARDWARE FORMS 235eJhnNob2 
NO IMPLIED FORM FEED 25eJAN@82 
OB20(7- 188) IZZY. TXT31 25eJAN=62 


OB2rl(Ty toa) IZZY. TXT91 
copy 1 OF 1 
DELETION NOT SPECIFIED 


2S5eJANo82 
25~JANe82 
25eJAN@82 


PRINT (Cont.) 


18129;53 
12529553 
18329:53 
16529853 


18129353 
18829153 


18529153 


18129353 


10129959 
10129359 
18329159 


B1234567898123056789 
Bi 23e5a7S5FS1 25058709 
812345678981 23850789 
61230507899123050769 


82234567890123050789 
642345678901 23480789 
812395678991 23050789 
812345678901234560789 


01234567899123056789 
91234567690323456789 
12345678981 23450789 


YY 
YY 
YY 
YY 


M 
ut 
tis 
1134 
11 
11 
ii 
Mt 
11 
ut 
it 
it 
viaag) 
Vyaadi 


@1234567890123456789 ae RSXOLIMePLUS V2 ee 
61234567892123456789 ek REXSLIMSPLUS Vo ae 
O123456789012345678¢ te RSXeLiMePLUS V2 xe 
01234567890123456789 aa RSXeLIMePLUS V2 *¢ 
wi WW =-RRRRRRRR TIYITII TITTTITTT 
Ww wh RRRRRARR TIIITII TTTTITTT 
Wi WW RR RR Il TT 
we we ORR RR iI TT 
WH WW RR RR Il TT 
wa wie RR Re Tl TT 
WH WH RRRRRRRR TT TT 
WW WW -RRRRRRRR ql TT 
WW Wa Wi RR RR Ir TT 
Wa Ww oOWW RR RR qr TT 
WhWh = WHWW RR RR II TT 
WWW WHRR RR RR il TT 
Ww Ww RR RR TITIT TT 
wi whee ORR RR TIIIIZ TT 
IIIII Z2Z2Z727ZZ_—_- AAAAZZZZZZ— YY 
IIIT Z2Z2Z2ZZZZ_—-ZZZZZZZZZZ—_—VY 
9; zz zs 
TI zz zz OY 
II zz zz yy YY 
I! P74 22 yy YY 
I! zz 22 YY 
Tl 22 22 yy 
ii zz Zz YY 
iW 2 YY 
iW 22 2z yy 
534 rz4 22 yy 
TIITIT ZWZZZZZZZ_———- AZAZZZZZZZ YY 
IIIT 2Z222Z2ZZZZ_—- ZAAZZZZZZZ YY 
81234567890123456789 wae RSX*LIMOPLUS V2 ** 
@3234567890123456789 ae R&XoLiMePLUS V2 «* 
81234567890123456789 we RSXo1{MePLUS V2 a0 
812345678901 23456789 ee RSXeLIM@PLUS V2 ae 
012345678901 23456789 we RSXe1{MePLUS V2 xe 
812395678901 23456789 we RSX@LIM@PLUS V2 ae 
81234567890123456789 ae REXSLIM@PLUS V2 ee 
IIIT! 2222222222 «= 22ZZZZZZZZ_—YY 
IIIII 22Z22Z2ZZZZ_— AAZZZZZZZZ—VY 
I rz4 74 YY 
I zz zz ¥¥ 
1 Zz zz yy oY 
IT 22 Z2 VY VY 
TI zz zz YY 
M1 22 22 YY 
I! 4 2Z YY 
TI 22 zz YY 
TI rd rz4 YY 
II zZ zz YY 
TTIII 22222722222 = 22722227222 YY 
IIIIII 22222ZZZZZ_—-WZZZZZ2ZZZZ YY 
TITTTTTTTT xX XK TTTTTITTTT 3s 
TTTTTTITTITT xx xx TITTITTITT yoas 
TT xx xx TT eee 
TT XX Xx TT eee 
TT Xx XK TT 
TT MX XX TT 
TT xy TT jiii 
TT xXx TT yoay 
TY: XX XX TT wns 
TT Xx XX TT 1098 
TT xX Xx TT ” 
TT xx xx 1? ” 
TT xx xXx 1T iz) 
TY xX XX 1? 8 
912345678921234656769 #e RSXe1IM=PLUS V2 2% 
012395678981 23456789 #e R&Xo1IM@PLUS V2 e 
@32325678981234567a9 fe RSXo1{MePLUS V2 ae 


Figure 4-2 


DB]r7,18G)IZZy,7XTsh 
copy 1 OF 1 
DELETION NOT SPECIFIED 


Job Flag Page 


25eJAN@B2 
25eJAN@B2 
25=JAN@B2 


18329159 
18329759 
12129359 


81234567899123450789 
81234567890123056769 
9123456078981 23450789 


ZK-563-81 


and File Flag Page 


HANDLING FILES 


PRINT (Cont.) 


/ [NO] LOWERCASE 


Specifies that the print job must be sent to a line printer 
having the lowercase character set. The default is /NOLOWERCASE. 


/PAGE_COUNT:n 


Sets a limit on the number of pages the job may produce, ranging 
from 1 through 32767. 


Without this qualifier, the number of pages is unlimited (n=0). 
/NAME: jobname 


Specifies a name for the print job. Your job name can be nine 
alphanumeric characters. 

If you specify a job name, that name appears on the flag page at 
the beginning of the printed output. Otherwise, the file name of 
the first file is used as the job name. 


The job name also appears in the SHOW QUEUE display. The job 
name includes the UIC under which it was entered. 


There can be more than one job of the same name, but each job has 
a unique entry number which appears in the SHOW QUEUE display. 


/PRIORITY:n 


Sets the queue priority of the print job. For nonprivileged 
users, n can be from 0 through 150. Privileged users can set n 
up through 250. The default is 50. 


The Queue Manager prints the highest priority jobs first. When 
two jobs have the same priority, the job that has been in the 
queue longest is printed first. 


/FORMS:n 


Specifies the type of form on which the job must be printed. n 
can have a value from 0 through 256. The default is 0. See your 
system manager for details on how to specify the particular forms 
used at your installation. 


/LENGTH:n 


Sets the length of a logical page; n can be any number from 0 
through 255. The default is n=0. If you set a length, a form 
feed is automatically generated if one is not found within no 
lines. 


When you set the length at 0, the default, the logical page 
length is unlimited. 


This qualifier has no effect on how the printer handles form-feed 
characters. A form feed still moves the printer to the top of 


HANDLING FILES 


PRINT (Cont.) 


the next physical form, such as the perforation in a sheet of 
line-printer paper. This qualifier simply adds the requirement 
that the printer move to the top of the next physical page if no 
form-feed character is encountered within n lines. See the 
example using /LENGTH. 


/ {NO] RESTART 


Controls requeuing of your job if it is stopped or aborted while 
being processed. 


If /RESTART is specified, your job startS again from the 
beginning if it is aborted. 


/NORESTART is the default. If the printer is stopped while your 
job is active, the job picks up where it left off when the 
printer is started. : 


In neither case are you missing any of your job, but with 
/RESTART your job is all in one piece. 


If, however, the paper jams in the line printer, the operator 
must see that your job is restarted above where the jam began. 


/{NO]FLAG PAGE 


Adds flag pages to each file in your print job. With /FLAG PAGE, 
the number of flag pages is equal to the number of job flag pages 
that precede the job. 


With /NOFLAG PAGE (the default), your job is still preceded by a 
job flag page, but the files in the job are printed without any 
file flag page, separated only by form feeds. You can suppress 
the job flag page with the /NOJOB PAGE qualifier. Figure 4-2 
shows the difference between the job flag page and the file flag 


page. 


/AFTER: (dd-mm-yy hh:mm: [ss] ) 
(mm/dd/yy hh:mm: [ss] ) 


Blocks the job until after the specified time. Depending on the 
print queues at that time, your job may be run immediately, or 
later, when its turn comes up in the queue. 


The parentheses, hyphens (or slashes), colons, and the_ space 
between the calendar and clock fields are all necessary syntax. 
Note that a space is used only between the calendar and clock 
fields. The space is not necessary if either field is omitted. 


You can specify the calendar field in either of two formats: 


dd-mm-yy Uses a l- or 2-digit number for the day, the first 
three letters for the month, and two numbers for the 
year. 


mm/dd/yy Uses a l- or 2-digit number for the month, a 1- or 
2-digit mumber for the day, and two numbers for the 
year. 


HANDLING FILES 


PRINT (Cont.) 


If you leave out the calendar field, the day defaults to the 


current date. 


yy must be between 77 and 92. If you leave it out, the year 


defaults to the current year. 


hh:mm:ss is the hour, minute, and second. 


If you leave out the clock field, the time defaults to 00:00:00 


on the given date. 


ss need not be given. It defaults to 00. In fact, you cannot 
specify ss. If you do, it is checked for syntax only. The Queue 


Manager always takes a few seconds to start the job. 


Specifying a time using /AFTER is equivalent to issuing a Print 
command at that time. The job may still have to wait in its 


queue to be printed. 
/ [NO]WIDE 


The /WIDE qualifier specifies that the file must be printed on 


a 


processor that has been initialized /WIDE. The default is 


/NOWIDE. 


File Qualifiers 


These qualifiers are used to override the corresponding command 
qualifiers when you have given multiple filespecs as parameters 


to the PRINT command. 
/COPIES:n 


Overrides the /COPIES command qualifier when attached to 
particular filespec. 


/ [NO] DELETE 


Overrides the /{NO]DELETE command qualifier when attached to 
particular filespec. 


ZANOLPRANGEER:| 


ppeedrnane ithe /1NO] TRANSFER ‘comhand qualifier when attached Ato a 


particular. filespec ON RSX-11M-PLUS Systems. 


Examples 
SPRINT 
File(s)? PASHA.CMD 
FRI -- Job 395, name "FASHA ", submitted to aveue "PRINT 


a 


This example prints the most recent version of PASHA.CMD from the 
default device and UFD on the line printer. The Queue Manager 


returns a message confirming that the job has been submitted 

giving an entry number. You can use this entry number in 
commands. See Chapter 9, and also the RSX-11M/M-PLUS Batch 

Queue Operations Manual. 


and 
QMG 
and 


HANDLING FILES 


PRINT (Cont.) 


sFPRINT/COPIES? 206 
File(s)? PASHA.CMI 
FRI -- Job 766, mame "FASHA "» submitted to eueue "FRINT " 


This example prints 20 copies of PASHA.CMD. They are printed 
end-to-end with no flag page except at the beginning. 


“PRI/COP?LZSO/FLAG_PAGE FASHA.CHE 
PRI -~- Job 321 neme "FASHA ", submitted to aueue "FRINT ° 


This example prints 20 copies of PASHA.CMD, each with a flag 
page. 


>PRIN/COFIES?2 DAVIO.TXT, DAN. TXT 
FRI -- Job 18, mame "TAVIT “, submitted to aueue "FRIWT * 


This example prints two copies of DAVID.TXT followed by two 
copies of DAN.TXT. It does not print two sets of one copy of 
each file. If you wish to print sets of files, see the next 
example. 


SERINT/JOB_COUNT32 DAVID.TXT: DAN.TXT 
FRI -~- JOB 31lis NAME "TDAVIE “, suomitted to aueue "PRINT * 


This example prints a set consisting of a copy of DAVID.TXT 
followed by a copy of DAN.TXT, and then prints another set of 
DAVID.TXT followed by DAN.TXT. 


*FRI/FLAG FASHA.CMD> RAJAH. CMDs SHEINK.CHO 
FRI -- Job 999, name "FPASHA ">; submitted to euewe "“FRINT * 


This example prints one copy of each file, each with its own flag 
page. 


oPRI/NAME SARABY/FLAG FASHA.CMU: RAJAH-CMOs SHETIE.CMD 
FRI -- JOB 805, NANE “A&RABRY "> sguomitted to Gueue "FRINT * 


This example prints one copy of each file, each with its own flag 
page, and gives the name ARABY to the job as a whole. The name 
ARABY appears in the print queue and at the head of the entire 
printed output. 


SPRINT/SLENGTH?S6O GLADRAG. MAC 
FRI -- Job 22+ neme “GLADRAG “>y syoOmitted L6O @eeaeue “FRINT * 


This example prints a single copy of the file GLADRAG.MAC. This 
is a source program file without form-feed characters in it. The 
user wants to print it on line-printer paper, a physical form 66 
lines long. To avoid printing over the perforations, the user 
nas specified a logical length of 60 lines. Each time 60 lines 
have been printed, the logical page is complete and the printer 
moves to the top of the next physical page. 


HANDLING FILES 
PRINT (Cont.) 


If the file had form feeds in it, the printer would move to_ the 
top of a physical page each time it encountered a form feed and 
each time it printed 60 lines without encountering a form feed. 


“PRI/COFIES!20 MOB.COR> RIFRAF.COR: RABBLE.COR/COPt{19,» FROLE.COR 
FRI -- Job 77, name "MOB "s,s submitted to aqueue “FRINT * 


This example prints 20 copies each of MOB.COR, and RIFRAF.COR, 19 
copies of RABBLE.COR, and then 20 copies of PROLE.COR. 


“PRI/DELETE LASER.TST: FHASER. TST: RAZOR. TST/NOLGELE 
FRI -- Job 404, mame "LASER *", submitted to aueue "“FRINT * 


This example prints the three files and deletes the first two 
from the current UFD. 


Only the versions specified in the PRINT command are deleted, in 
this case, the most recent versions of LASER.TST and PHASER.TST. 


SPRI/SAFTER!? (4-5UL-82 13713) CONST.CON 
FRI -- Job 809 mame "CONST *", eubmitted to aueue "PRINT * 


This example blocks the job in its queve until the specified date 
and time. The file itself remains in its UFD. Deleting the file 
from its UFD does not take it out of the queve, but does prevent 
it from being printed. 


SFRI/AFTER?¢172060) GUNGA.TDIN 
PEI -- Joab 7465? mame “GUNGA "> submitted to queue "FRINT * 


This example prints the file after 5 P.M. on the day the command 
is entered. If the command is entered after the specified time, 
the file is printed immediately. 


Notes 
P is the short form of PRINT. 


The PRINT command does not accept the "%" wildcard. The "*" 
wildcard can only be used to substitute for a complete part of 
the filespec and NOT for part of a file name or file type as the 
PIP-related commands do. 


For more information on the PRINT command, see the RSX-11M/M-PLUS 
Batch and Queue Operations Manual. This manual also includes a 
description of the SHOW QUEUE command, which displays information 
about print jobs in queues. 


PRINT is to print jobs as SUBMIT is to batch jobs. The PRINT 
command defines QMG print jobs. 


Once your job is in a queue, you can modify some job attributes 
with SET QUEUE. See the RSX-l1M/M-PLUS Batch and Queue 
Operations Manual. 


The Queue Manager automatically deletes .PMT and .DMP files after 
they are printed. 


HANDLING FILES 


APPEND 


The /LOWERCASE and /UPPERCASE qualifiers have no effect on the 
nature of your output. They do not cause your job to be printed 
all uppercase or in lowercase. Rather, these qualifiers must 
match the attributes given to the printer when it was 
initialized. A printer without the lowercase character set can 
be initialized /LOWERCASE and accept print jobs with the 
/LOWERCASE qualifier on the PRINT command. This might be done if 
a printer with the lowercase character set was temporarily 
unavailable. In most cases, only printers with the lowercase 
character set are initialized /LOWERCASE, however. 


Despite your setting of the /[NO]RESTART qualifier, your job may 
be restarted by commands to the Queue Manager from your system 
manager. See your system manager if you have jobs’ where 
restarting or not restarting may be a problem. 


The flag pages and the job pages have different formats for the 
banner text. The job name page shows the UIC the PRINT command 
was issued under on the first line and a 9-character job name 
(derived from an explicit job name or the file name of the first 
file in the job) on the second line. The flag page shows’ the 
full 9-character file name on the first line and the file type 
and version number on the second line. See Figure 4-2. 


Entry numbers run from 1 through 999 and are unique. Various QMG 
commands permit you to identify your job either by this number or 
by job name. The job name includes your UIC. See Chapter 9 and 
also the RSX-11M/M-PLUS Batch and Queue Operations Manual. 


4.4.3 APPEND 


APPEND appends to an existing sequential file records from one or more 
sequential files. 


Format 
APPEND[/qualifier[s] ] 
File(s)? infile[s}] 


To? outfile 


APPEND[/qualifier[s]] infile[s} outfile 


HANDLING FILES 


APPEND (Cont.) 


Command Qualifiers 
/DATE: dd-mmm-yy 
/SINCE:dd-mmm-yy 
/ THROUGH: dd-mmm-yy 
/ SINCE: dd-mmm-yy/ THROUGH :dd-mmm-yy 
/ TODAY 
/ EXCLUDE: filespec 
Parameters 
infilie[s]j 


Specifies the file or files to be appended to the output file. 
You can use APPEND only on sequential files. 


outfile 
Specifies the file to which the input files are appended. 
The output file must be an existing sequential file. The output 
file has the same version number after the APPEND command is 
executed as it had before the command was issued. The input 
files appear at the end of the output file in the order they were 
specified. 


No wildcards are permitted in output file specifications. 


a a a os ee A a a mE 


Although the output file must exist, it may be an empty file. 
Command Qualifiers 
/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the APPEND command to 
affect only files created on the date given. 


/SINCE:dd-mmm-yy 


The /SINCE qualifier specifies that you wish the APPEND command 
to affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the APPEND command 
to affect only files created on or before the date given. 


/ SINCE: dd-mmm-yy/THROUGH: dd-mmm-yy 
The /SINCE and /THROUGH qualifiers can be combined to. specify 
that you wish the APPEND command to affect only files created 
within that range. 

/ TODAY 
The /TODAY qualifier specifies that you wish the APPEND command 


to affect only files created on the same day the command is heing 
issued. 


HANDLING FILES 


SORT 


/EXCLUDE:filespec 


The /EXCLUDE qualifier specifies that you wish the APPEND command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 


Examples 


APPEND 
File(s)? BIRD.,DOGs* 
To? JOKER. TXT 


This example appends copies of all versions of BIRD.DOG in order 
to the end of the most recent version of JOKER.TXT. 


APPEND &.LST LIST.FIL 


Appends copies of most recent versions of all files of the type 
~-LST to LIST.FIL. Appended files appear in the order they are 
listed in the directory. 


Notes 


APPEND does not delete the input files. They remain intact. 
Copies of the input files are placed at the end of the output 
fide. 


4.4.4 SORT 


SORT invokes the unbundled SORT-11 utility. If your system includes 
SORT-11, the SORT command allows you to read an input file, sort the 
contents, and write out the sorted data to an output file. The 
sorting sequence is determined by control fields called key fields 
within the data. 


Format 


SORT/KEYS: (abm.n[:abm.n...])[/qualifiers] infile[{/FORMAT:arg] [/qualifier[s]] outfile[/qualifier[s]] 
Command Qualifiers 


/ ALLOCATION: n 
/BLOCKSIZEin 
/BUCKETSIZE:n 

/ [NO] CONTIGUOUS 
/DEVICE:ddnn: 

/WORK FILES:n 

/FORMAT: fmt[:n] 

/ PROCESS: type 

/SIZEin 

/SPECIFICATION: filespec 


HANDLING FILES 


SORT (Cont.) 


File Qualifiers 
/FORMAT: fmt :n 
/INDEXED:n 
/RELATIVE 
/ SEQUENTIAL 
Format Arguments 
FIXED:n 
STREAM: n 
UNKNOWN: n 
VARIABLE?n 
Parameter 
infile 


Specifies the file you wish to sort. The file must be in a valid 
RMS-11 format. The default file type for input files is .DAT. 


outfile 
Specifies the file where you wish the sorted output written. 
Command Qualifiers 
/KEYS: (abm.n) 
Specifies the keys on which the sorting is to be based. This 
determines the sequence in the output file. You must enclose the 
argument to /KEYS in parentheses. For defaults, see the first 
two examples. 


abm.n 


Specifies the key field. You can specify up to 10 key 
fields, separated by colons, such as the following: 


/KEYS: (BN1.6:C8.2) 

The default is /KEYS:(CN1.9). See the examples. 

a Describes the data in the file and thus how it is to be 
handled. Tf the character is omitted, the default 
value is C. The possible values are as follows: 


B, Cy D, EF, I, J, K, P, Z 


The meaning of each of these characters is described 
under Data Description Characters. 


b Defines the general sort order. The possible values 
are: 
N Ascending order (the defauit) 
fe) Opposite, or descending, order 


HANDLING FILES 


SORT (Cont.) 


m A decimal number giving the first byte of the key field 
Starting from 1. This number must be explicitly 
stated. 


n A decimal number giving the length of the key field in 
bytes. This number must be explicitly stated. 


Data Description Characters 


B Two's complement binary. 
Cc Alphanumeric. 
D If the characters are alphabetic, numeric with the sign 


Superimposed over the units digit, or contain slashes (/), 
use the value of the digits group. For example: 


A2CD5 = (+) 12345 and A/47J = (-) 11471 
If the characters represent a standard FORTRAN-IV number, 
such as 12, -35, 42.98, or -0.76E+3, convert the number to 
binary for storage or evaluation. 


F 2- or 4-word floating point binary. 


I Same as D, but with the sign leading and separate, so that 
the first byte of the field is a+ or -. 


J Same as I but with the sign trailing and separate. 
K Same as D but with the sign leading and overpunched (54321, 


for instance if positive, would come out as 5432A. the 
negative of 54321 would be 5432J). 


p Packed decimal format. 
Z ASCII zone. 
/ALLOCATION:n 


Specifies the initial space allocation for the output file. 
Legal values range from 0 through 65,535. If you do not use this 
qualifier, the output file allocation defaults to the input file 
size for the record and tag sort processes. For index and 
address routing sort processes, the default size is based on the 
number of records sorted. 


/BLOCKSIZE:n 
This qualifier is valid for magnetic tapes only and is used _ to 


specify a nonstandard magtape block size. If this qualifier is 
not used, the block size defaults to the standard 512-byte block. 


HANDLING FILES 
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/BUCKETSIZE:n 


Specifies the RMS-11 bucket size (the number of 512-byte blocks 
per bucket). Please note that the size of the block is the 
standard 512 bytes even if the /BLOCKSIZE qualifier is used. The 
default value of this qualifier depends on the organization of 
the input file. If the input and output files are of the same 
organization, the default for the output file is the input file 
value. If the input files differ in organization or the default 
is required for the input file, the default value is l. 


/ {NO} CONTIGUOUS 
Specifies that the output file be contiguous. This means’ that 


each block in the file will be physically located between its 
logical predecessor and its logical successor with no filler or 


extraneous material separating blocks. The default is 
/NOCONTIGUOUS. 

/DEVICE:ddn: 
Specifies the device on which you want the scratch files. This 
qualifier overrides any device specification from Task Builder 
options. 


/WORK FILES:n 


Specifies the maximum number of intermediate scratch files. 
Leqal values are from 3 through 8. The default value is 5. 


/SPECIFICATION: filespec 


Specifies the name of a file containing SORT-11 controls for the 
kind of sorting process to be used. 


/PROCESS: arg 
RECORD 
TAG 
ADDRESS ROUTING 
INDEX — 


Specifies the type of sorting process to be used. The default is 
RECORD. 


/RELATIVE 


Specifies that the output file is to have relative file 
organization. 


/ SEQUENTIAL 


Specifies that the output file is to have sequential file 
organization. 
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Specifies the size of the retrieval window. The ranges. and 
defaults for this qualifier are determined by the operating 
system. See your system manager for further information. 


File Qualifiers 


/FORMAT: arg 
FIXED:n 
STREAM: n 
VARIABLE:n 
UNKNOWN: n 


Specifies the record format and the maximum size (n) in a file. 
The maximum record size n is the exact record size in bytes for 
FIXED length records. For other formats, n is the size in bytes 
of the largest record present. You must specify a value for n 
for input files. 


The default is /FORMAT:FIXED:84. 


This file qualifier specifying the format of input records can be 
overridden by the corresponding file qualifier for output files. 


/INDEXED:n 


Specifies that the input file has the indexed sequential file 
organization. n specifies the number of keys. There is no 
default for n. 


Examples 


“CREATE PHONE. TXT 

BAKER 

FOX 

EASY 

CHARLIE 

ABLE 

LOG 

CTRL/Z) 

SORT 

Ineut file? FHONE.TXT 

Quteut file? FHONE.OUT 

SRT ~-- mi ELAPSED REAL TIME? 00200104 
SRT -- mi TOTAL RECORDS SORTEL é 
2TYPE FHONE. OUT 

ABLE 

BAKER 

CHARLIE 

OG 

EASY 

FOX 
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SORT (Cont.) 


This example illustrates the defaults for the DCL SORT command. 
The user created a file where no record (line) is longer than 80 
characters. SORT-1l sorted the file on the basis of the first 
nine characters. This sorting is in ASCII sequence, meaning that 
symbols are sorted first, followed by numbers, followed by 
uppercase letters, followed by lowercase letters. 


SSORT/KEYS?(CN1.9) FHONE.TXT/FORMATSFIXED?84 FPHONE.OUT 


This example is the equivalent of the previous one, with defaults 
explicitly stated. SORT-11 itself has no defaults for these 
values. The defaults come from DCL. 


> DIRECTORY SLMINDEX.FIL 


DIRECTORY DR1iC303+5) 
9-AUG-82 11340 


SLMINDEX.FIL$1 69, 09-AUG-82 11700 


TOTAL OF 69./69. BLOCKS IN 1. FILE 


> SORT/KREY: (CNL. 9) /DEVINBOL/FILES3/SEQ/FROCI REC SLMINDEX.FIL/FORSVAR!100 SLMINIEX.TST 
SRT -- MSELAFSED REAL TIME! 00200:30 
SRT -- Mi TOTAL RECORDS SORTEL: ~ 1410 


> DIRECTORY SLMINDEX.*& 


RDIRECTORY DB1L:C303r5) 
9-AUG-82 11:41 


SLMINDEX.FIL#1 &9. 09-AUG-82 11°60 
SLMINBDEX.TST31 6B. O9-AUG-82 112341 


TOTAL OF 137.7138. BLOCKS IN 2. FILES 


In this example, the user started out with a file SLMINDEX.FIL, a 
variable format file with the largest record size 100 bytes. The 
key field is specifed as CN1.9. The C indicates the file is to 
be sorted as an alphanumeric file. The N specifies ascending 
order. The 1 indicates that the sort is to start on the first 
byte of each record and the 9 indicates that the sort is to 
continue through the ninth byte of each’ record. The command 
directs that three scratch files be created on DBO: and then 
deleted after the operation completes. The output file is 
requested to be sequential and the sort is specified as a record 
sort. 
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In other words, the file is a sequential file containing numbers 
and letters with up through 100 characters per record (line). 
The user wishes these records sorted on the basis of the first 9 
characters in each record with the resulting sort in ascending 
order, with the lower ASCII values first and the higher ASCII 
values following. Note that while the ASCII values go up as you 
go through the alphabet, all lowercase letters have higher values 
than any uppercase letter. Furthermore, characters such as 
blanks, tabs, bells, and the like have the lowest ASCII values. 


Notice the messages informing you of the time elapsed from _ the 
time you entered the command until the sort completed and of the 
number of records sorted. 


Notes 


SORT-11 is an unbundled product that is not available on all 
systems. The SORT command depends on the presence of SORT-11l. 
The file SORT.TSK should be located in the system directory on 
RSX-11M or the library directory on RSX-11M-PLUS. 


Thus, you can also invoke SORT-11 with the command 
>RUN SSORT 


If you run SORT-11, you must enter commands in the SORT-i11 
format, not the DCL format. 


You cannot use the SORT command without an understanding of 
SORT-11. See the PDP-11 SORT Reference Manual. 


4.4.5 DIFFERENCES 


DIFFERENCES compares two ASCII (text) files line by line to determine 
if parallel records (lines) are identical, and produces a listing of 
the differences between the files, if any. 


Format 


DIFFERENCES [/qualifier[s] ] 
Filespecl? infilel 
Filespec2? infile2 


DIFFERENCES [/qualifier[{s]] infilel infile2 
Command Qualifiers 


/CHANGE BAR[:n] 
/IGNORE: (arg[,s]) 
BLANK LINES 
COMMENTS 
FORM FEEDS 
SPACING 
TRAILING BLANKS 
/LINES:n = 
/NONUMBERS 
/OUTPUT: filespec 
/SLP[:au] 


HANDLING FILES 
DIFFERENCES (Cont.) 


Parameters 
infilel 


Specifies the first of two files to be compared. The file name 
must be included. The default file type is .MAC. 


infile2 


Specifies the second of two files to be compared. The file name 
must be included. The default file type is .MAC 


Command Qualifiers 
/CHANGE BAR[:nnn] 


Specifies that the output consists of a listing of infile2 with 
change bars applied to each line in infile2 that does not have a 
corresponding line in infilel. The nnn argument is the number of 
the ASCII character to be used for the change bar. The default 
is 041, the exclamation point (!). Here are the codes for some 
commonly used ASCII characters: 


041 
043 
044 
052 
053 
074 
076 
077 
074 


— VV AN +t FH ee 


/IGNORE: (arg[,$]) 
BLANK LINES 
COMMENTS 
FORM FEEDS 
SPACING 
TRAILING BLANKS 


Specifies that you wish certain defaults to be ignored in making 
the comparison. Without the /IGNORE qualifier, the comparison is 
strictly line-by-line. If you specify only one argument, you do 
not need the parentheses. If you specify more than one argument, 
enclose them in parentheses and Separate them with commas (,). 


The default is to include all these factors in the comparison. 


The BLANK LINES argument specifies that blank lines are to be 
excluded from comparison. The default is to include blank lines 
in the comparison. 


The COMMENTS argument specifies that comments, that is, text 
preceded by a semicolon (;) not be included in the comparison. 
H 


1 
, re er eee c ere cwoamnmarse tla os ~ oy ay 
otherwise, comments are compared like ail other text. 
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The FORM FEEDS argument specifies that lines beginning with a 
single form-feed character (CTRL/L) are to be excluded from the 
comparison. The default is to include such lines in the 
comparison. 


The SPACING argument specifies that any sequence of blank and tab 
characters is to be interpreted as a single blank for the 
comparison. This argument is useful when comparing source files 
that differ only in their spacing. The output listing includes 
blanks and tabs as they are found in the input files, but the 
blanks and tabs are ignored. The default is to compare sequences 
of blanks and tabs like any other characters. 


The TRAILING BLANKS argument specifies that all blanks following 
the last nonblank character in the line be ignored in the 
comparison. The default is to compare trailing blanks like all 
other characters. If you specify both TRAILING BLANKS and 
COMMENTS in your /IGNORE qualifier, any blanks preceding a 
semicolon (;) are also ignored. 


The DCL DIFFERENCES command does not have quite the same defaults 
as CMP, the File Compare Utility, which DIFFERENCES invokes. 
Specify /IGNORE: (BLANK LINES,FORM FEEDS) to duplicate the CMP 
defaults for blank lines and form feeds. Other CMP defaults need 
not be specified. 


/LINES:n 


Specifies that n lines must be identical before a match is 
recognized. The default value for n is 3 identical lines. 


/ {NO] NUMBERS 


/NONUMBERS specifies that lines in the output file not be 
preceded by line numbers. The standard output listing 
automatically includes line numbers. Line numbers start with 1 
in increments of one. All lines are numbered, including blanks. 


/OUTPUT:filespec 


Specifies that the output listing be written to the file named in 
the qualifier. Normally, this output appears on your terminal. 


/SLP[:au] 


Specifies that the output listing take the form of a SLP indirect 
command file. When you include this qualifier, the output 
listing is an SLP indirect command file that makes infilel 
identical to infile2. The optional au argument, preceded by a 
colon, is a 1- through 8-character alphanumeric audit trail 


symbol. For more information on the Source Language Input 
Program (SLP), see Chapter 13 of the RSX-1LIM/M-PLUS Utilities 
Manual. 


HANDLING FILES 


DIFFERENCES (Cont.) 


Examples 


The following examples use several slightly different versions of 
the same MACRO-11 source file for comparisons. The full text of 
version 1 is printed here. Version 2 is identical except for 
that one Executive directive is different; version 3 has 
additional blank lines inserted. In each instance, the "IDENT" 
number matches the version number. 


Here is the text of version 1: 


-TITLE WRITE PRINT A PREDEFINED MESSAGE ON THE USER’ TERMINAL 
- IDENT "01" 


-MCALL ALUNSC, QIOWSC, EXSTSC 


STRING: .ASCII "This is a simple MACRO-11 program." 
LENGTH = --STRING ; CALCULATE THE STRING LENGTH 
EVEN 


START: ALUNSC 1,TI,0 ; ASSIGN THE LUN TO USE TO THE TERMINAL 
QIOWSC I0.WVB,1,1,,,,STRING, LENGTH, 40> 
; PRINT THE STRING 
EXSTSC EXSSUC ; SUCCESSFUL EXIT IN ALL CASES 


- END START ; SETUP THE STARTING ADDRESS 


In the following examples, a "difference" as defined by the 
DIFFERENCES command, consists of one or more lines that differ in 
the two files being compared. Each “difference™ ends when the 
first matching line is encountered. The listing of the 
"difference" includes all the nonmatching lines AND the first 
matching line. 


>DIFFERENCES/IGNORE! (BLANK LINES» FORM. FEES: 
Filesreci? TOM.MACH1 
Filesrec2?? TON.MACH2 
PoP PSPSPS PesPeee se SeesSeseSestss sss eeset eee eeee ses s 5 
1) DRE? C303;S1TOM. MACS I 
~IDENT "01° 
*MCALL GLUNECD, GTOWSCe EXSTEC 
é STRING? . ASCII "This i5 68 simele MACRO-]1i erogram, " 
KKKKKERARKKEKKKKK 
2) TR2:C3O63-+SITOM. MACS? 
2 »IDENT "02° 
4 »>MCALL ALUNSC,s QIOWSCs EXST$S 
é STRING? .ASCIIT ‘“This is 3 simele MACRKO-1i Frosgram." 
Il differences found 
TIi/-BL/-FF/-CB=TOM.MAC#1,TOM.MAC? 2 


> ho 


In this example, the user compared two files that differ only in 
one Executive directive -- EXST$S or EXSTSC -- and in their 
version numbers. The user specified 


/IGNORE: (BLANK LINES,FORM FEEDS) 


e defaults of 


iw MN UMUust_ uw wie 


roduce t CM the File Compare utility 
FFERENCES command invokes. 


ee ee ee id 
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The listing of differences between the two files starts with the 
IDENT numbers on line 2 of the files. The next line is blank in 
both files. Although the line is numbered, it is not printed on 
the terminal and is ignored in the comparison. It would not 
change the results if one file had the blank line there and one 
did not. 


The next listed difference is in the Executive calls on line 4. 
Again, the blank lines are not shown. The next line of code 
listed is the same in both files. This marks the end of a group 
of lines that are different in the two files. 


The command line reprinted at the bottom of the listing is the 
CMP command line equivalent to the DIFFERENCES command. 


SDIFFERENCES TOM.MAC?1 TOM.MACS 2 

Pe SSPSSSSSESSSESESLSSSSVSSSSSSSE SES SSS SSS PTET Se 2S 2 5: 
1) DB2:C303,S3TOM. MACE 

: eLUENE Gd 


J 


*MCALL ALUNSC, QIOWSC, EXSTSE 


Ch te Gl ft 


KKKK KKK ERK EEK EK 
2) DR2IC303sS51 TOM. MAC? 2 
+ITDENT "“O2* 


»+MCALL ALUNGSCs GIOWSC, EXST#S 


Cho OG] bh 


i differences found 
TIi/BL/FF/S-CB=TOM.MAC#1+TOM. NACHO 


This example illustrates the defaults for the DIFFERENCES 
command. The results are the same, but the blank lines are 
printed. If one file had had more blank lines than the other, 
the results would not have been the same. See the examples 
comparing version 1 and version 3. 


“DIFFERENCES/CHANGE.BAR/IGNORE! (BLANK _LINES+FORMFEENS) TOM.MAC?1 TOM.MACI2 
i +TITLE WRITE PRINT A FREDEFINED MESSAGE ON THE USER TERMINAL 


2 | ~IDENT ‘*o2" 

4 1 »>MCALL ALUNSCy, QIOWSC, EXST$S 

& ! STRING: .ASCII ‘'This is @ simple MACRO-i1 frogram. * 

7 LENGTH = »-STRING ¢ CALCULATE THE STRING LENGTH 

8 +EVEN 

10 START: ALUNSC 1:TI+0 + ASSIGN THE LUN TO USE THE TERMINAL 
1i QIOW$C TO.WVEsivlsssrsSTRINGs LENGTH? 40> 

12 3} PRINT THE STRING 

13 EXST$C EX$SUC # SUCCESSFUL EXIT IN ALL CASES 

15 »END START y SETUF THE STARTING ADDRESS 


1 differences found 
TI? /-BL/-FF/CB/VB? 3041=TOM.MAC#1»TOM.MAC32 
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This example shows the effect of the /CHANGE BAR qualifier. The 
second file is printed on the terminal with exclamation points 
next to the numbers of the changed lines. 


~DIFFERENCES/IGNORE? (BLANK LINES) TOM.+MAC31 TOM. MAC$ 3 
ORR RK KKK KR KKK KK KKK KKK KEKE 
1) DR2SC303,S51TOM. MACH 1 


2 »IDENT "OL" 
4 *MCALL ALUNSC, QTOWSC, EXSTSEC 
KKK KKK KK KKK KKK 


2) DR2:C303»SI]TOM. MACH S 
Ce RERT 2 OS" 


s 
4 *MCALL ALUNSC, QIOWSC? EXSTSEC 


1 differences found 
TIi:/-BL/FF/-CER=TOM.MAC# 1s TOM. MAC! S 


Versions 1 and 3 differ only in their blank lines and _ version 
numbers. In this example, with /IGNORE: (BLANK LINES), the only 
difference is in the IDENT numbers. The listing of the 
difference ends with the first line that is not different. Blank 
lines are numbered but otherwise ignored. 


SULIFFERENCE TOM. MAC#i TOM. MACH 
KEK EREKKERKEKKRKKKKKEKKRKRRE RK RK KKK KKK KARR KKKEKKAKE 
1) DB2:C303/SITOM. MACH 1 
2 IDENT "Oi" 
3 
SESS EE RES eres 
2) DR2°C303,51TOM. MAC? 3 
2 +IDENT "O03" 
3 
HAR RK KER RRR AR KK KR ARKR RRR RRR KKK RRR RRR KARR KR ER RR KKK 
1) DB2IC303sSITOM. MACS 1 


7 LENGTH = .- STRING $ CALCULATE THE STRING LENGTH 
JOG OOK 
2) DB2:C303+S5I]TOM.MACSS 
7 
8 LENGTH = »-STRING $ CALCULATE THE STRING LENGTH 


KARE RK RAK EKER KRKRARRRR KK ARA RRR AKER RK KE KKKKK 
1) DB2SCZO3sS5ITOM.MACII 
i1 QIOWSCIO.WVBrislesssSTRINGsLENGTH? 40> 
AXKKEKKEKERKERKE 
2) DB23C303,51TON. MACE S 


12 


13 QIOWSCIOWVEReieiersr,STRINGrLENGTH? 40> 


3 differences found 
TI? /BL/FF/-CB=TOM. MACs ix TOM. MACYS 


Comparing the same two files without specifying 
/ IGNORE: (BLANK LINES) has quite different results. Three 
differences are found. The first is the differing IDENT numbers. 
The other two differences are nothing more than blank lines. 
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Notes 


You can compare any two text files. They need not be MACRO-11 
source files, but most qualifiers to DIFFERENCE are for use with 
MACRO-11 files. 


The DIFFERENCES command invokes CMP, the File Compare Utility. 
See Chapter 12 of the RSX-11M/M-PLUS Utilities Manual. 


4.4.6 UNLOCK 
UNLOCK unlocks locked files. Locked files are files that have been 
improperly closed because a task aborted or stopped execution while 


the file was open. Locked files are identified by an L in the 
directory listing. 


Format 


UNLOCK[/qualifier[s] ] 
File(s)? filespec[s] 


UNLOCK[/qualifier[s]] filespec{[s]} 
Command Qualifiers 
/DATE:dd-mmm-yy 
/SINCE:dd-mmm-yy 
/ THROUGH: dd-mmm-yy 
/SINCE: dd-mmm-yy/THROUGH: dd-mmm-yy 
/ TODAY 
/ EXCLUDE: filespec 
Parameter 
filespec 
Identifies the locked file(s) that you wish to unlock. 
Command Qualifiers 


/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish the UNLOCK command to 
affect only files created on the date given. 


/SINCE:dd-mmm-yy 


The /SINCE qualifier specifies that you wish the UNLOCK command 
to affect only files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish the UNLOCK command 
to affect only files created on or before the date given. 
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/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 


The /SINCE and /THROUGH qualifiers can be combined to. specify 
that you wish the UNLOCK command to affect only files created 
within that range. 


/ TODAY 


The /TODAY qualifier specifies that you wish the UNLOCK command 
to affect only files created on the same day the command is being 
issued. 


/ EXCLUDE: filespec 
The /EXCLUDE qualifier specifies that you wish the UNLOCK command 
not to affect certain files. The filespec argument to /EXCLUDE 
can contain wildcards, but the version number must be given, 
either explicitly or as "*" wildcard. 


Example 


“Directory TOFEKA.KAN 
Directory DBOIC303s53 
2-NOV-82 13713 


TOPEKA. RAN: 3 a L 25-NOV-82 12:29 


Total of 323.740. plocks in i. files 
“UNLOCK TOPEKA» KAN 


“DIRECTORY TOPEKA. KAN 
birectory UROTC30%.53 
2-NOV-82 13¢44 


“+ 
PJ 
“a 


TOPEKA. KAN: 3 32. 25-NOV-82 12 
Total of 32.746. tlocks in 1. Files 


In this example, the user found a locked file, perhaps through an 
error message stating that the file could not be opened. The 
locked state is indicated by the L in the third column of the 
directory listing. After the user issues the UNLOCK command, the 
file is no longer locked. 


Notes 


In many cases, a locked file has no contents because the task 
that opened the file aborted before writing to the file. In this 
case, you do not need to unlock the file before deleting it. 


Another common case of file locking is a data file that has been 
opened by some task that aborted or exited without closing the 
file. In this case, you have to unlock the data file before 
running the task again. If the file is written to by the task, 
it may have been corrupted. 


HANDLING FILES 
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4.5 SET AND SHOW 


You can SET and SHOW your default device and UFD. You can SET 
PROTECTION on any file in your directory, or on a volume mounted on 
your private (allocated) device. 


4.5.1 SET DEFAULT 
SET DEFAULT establishes your default device or UFD, or both. 
Format 
SET DEFAULT [ddnn:] [[g,m] ] 
Parameters 
If you issue SET DEFAULT without parameters, your default device 


and UFD return to your login defaults, if you are nonprivileged. 
Privileged users must explicitly reset their login UFD. 


ddnn: 


Specifies the name of the device you wish to be your default 
device. The device must be a Files-ll device. The device name 
can be a logical name, but the SHOW DEFAULT display names the 
physical device. 


[g,m] 
Specifies the UFD you wish to be your default directory. 


When you change your UFD, the system checks your login UIC for 
your privilege. ii you are nonprivileged, you remain 
nonprivileged even if your new default UFD has a group number of 
10 or less. 


If you are privileged, this command changes your login UIC as 
well as your default UFD, but your privileges remain the same. 
In some cases, however, privileged users may have to reset their 
UFD to a privileged group number’ in order to use privileged 
commands. 


Examples 
“SET DEFAULT DRIICS03953 
This example sets DKl: as the default device and [303,5]}] as the 


default directory. All subsequent commands default to this 
device and directory unless you explicitly state otherwise. 


SET 


Notes 
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»SHOW DEFAULT 

DBitC303°5] TTSé! 

»SET DEFAULT DB2t£200/200) 
>SHO DEF 

DB21020072001 

»SET DEF 

»SHO DEF 

DEL:0303,5] 


This example illustrates the use of the unadorned SET DEFAULT 
command. The user started with the login default device of DB1: 
and the UFD [303,5], as given in the display from the SHOW 
DEFAULT command. Then, the user set the defaults to 
DB2:[200,200] and checked the setting with SHOW DEFAULT. 
Finally, the user issued SET DEFAULT without specifying any 
parameter. The user's defaults are returned to the login 
defaults. See notes. 


>SET DEF BRI: 
SASSIGN DRL? SYOt 


The two commands in this example are equivalent. In each case, 
the default device becomes DKl:. When you set the default 
device, SET DEFAULT actually assigns SY0: as a logical name for 
the device you wish. SY0: is the logical device name that 
represents your default device. 


SET DEFAULT is an unusual command in that it has differing 
effects depending on the presence or absence of its parameters. 


The only way to change your default UFD in DCL is’ through SET 
DEFAULT. When you issue SET DEFAULT including a UFD, DCL 
directly alters the default UFD held in your Unit Control Block 
(UCB). 


When you change your default device, however, SET DEFAULT 
generates the equivalent of an assignment of the logical name 
SY0: to the physical device you name, as shown in the examples. 


Conversely, when you issue the command without any parameters, 
SET DEFAULT generates the equivalent of a deassignment of the 
logical name SY0:, meaning that your default device assignment 
returns to your login SY0:, which is whatever device you log in 
to, and, for nonprivileged users resets your UFD to your login 
UFD. 


Since DCL is issuing two commands, it is possible that one may 
succeed while the other fails. 
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4.5.2 SHOW DEFAULT 


SHOW DEFAULT displays the current default device and UFD for 
terminal. ; 


Format 
SHOW DEFAULT 
Examples 


“SHOW DEFAULT 
DBLiCS039SI TT54i 


This example shows the display from SHOW DEFAULT, giving 
default device and UFD, plus the terminal name. 


“SHOW DEFAULT 
DRIiC303:51 T1543 
-SET DEFAULT Re: 


~ SHOW DEF 

DRO? C3OG4+54 TTa6: 

SSET DEFAULT DRISb1s 73 
~SHOW DEF 


QKL:Cis7] TTS56: 
“ASSIGN DT2: Y¥Y.: 
SET DEF ¥Y1i 
~SHOW DEF 
OT2:Cil»?7] TT36; 


In this example, the user first checked the defaults with 


your 


the 


SHOW 


DEFAULT, and then used SET DEFAULT to change the default device 


from DBl: to DBO:. The user checked with SHOW DEFAULT and 


then 


set the defaults to device DKl: and UFD [1,7]. After checking 


again, the user assigned the logical name YYl: to DT2: and 
YY 1% as the default device. Note that the subsequent 
DEFAULT display did not give the logical name YY1:, but 
physical name DT2:. 


Notes 


See Chapter 5 for more information on logical assignment. 


4.5.3 SET PROTECTION 


SET PROTECTION establishes the protection status of files. 


set 
SHOW 
the 


Protection status determines which categories of user may access a 


file and what each kind of user may do to the file. 


Nonprivileged users can set the protection of any files in their 
directory. 


own 
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Privileged users can set the protection of any file. 
Format 
SET PROTECTION: code[/qualifier[s]] filespec{s] 
SET PROTECTION[/qualifier[s] ] 
File? filespec[s] 
Code? (code) 
SET PROTECTION[/qualifier[s]] filespec[s] (code) 
Command Qualifiers 
/DATE:dd-mmm-yyy 
/SINCE:dd-mmm-yy 
/ THROUGH: dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH: dd-mmm-yy 
/ TODAY 
/ EXCLUDE: filespec 
Parameters 
filespec[s] 
Specifies the file or files for which protection is to be 
established. Multiple filespecs, separated by commas, and 
wildcards are permitted. All files you specify receive the 
protection status you specify. 
code or (code) 
Specifies which classes of users are permitted access to the file 
and what each class of user may do the the file. The parentheses 
are required syntax. 


There are four kinds of users: 


SYSTEM The operating system itself, and privileged 
users, those with group numbers of 10 or less 


OWNER The user having the same UIC as that the file 
was created under 


GROUP All users with the same group number as_- that 
the file was created under 


WORLD All other users 
There are also four kinds of access to files: 
READ The user, or the user's tasks, may read, copy, 
print, type the file, or run it, if it is a 


task image 


WRITE The user, or the user's tasks, may add new 
data to the file by writing to it 
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EXTEND The user, or the user's tasks, may increase 
the amount of disk space allocated to the file 


DELETE The user, or the user's tasks, may delete the 
file 


These forms of access are hierarchical. If you specify DELETE 
access, you are also granting READ, WRITE, and EXTEND access. If 
you specify WRITE access, you are also granting READ access but 
denying EXTEND and DELETE access, and so forth. 


The system default protection code is expressed as follows: 
(SYSTEM: RWED, OWNER: RWED,GROUP: RWED,WORLD: R) 


Under this code, the system, and privileged users, have full 
access to your files, You, as well as others with your group 
number, also have full access to your files. Other nonprivileged 
users can only read your files. If no other protection is 
specified, all files have this protection. In addition to the 
system default protection, there is default volume protection. 
See Section 4.1.5. 


If you wish to protect a file differently, use the same format, 
naming only the user group whose access rights you wish to change 
and the access form you wish to grant to that group. If you wish 
to deny all access to a group, simply name the group and omit the 
colon (:) and the code for the access form. 


Whenever any command specifies the protection code, enter it in 
this form. 


Command Qualifiers 
/DATE:dd-mmm-yy 


The /DATE qualifier specifies that you wish to set the protection 
only on files created on the date given. 


/ SINCE: dd-mmm-yy 


The /SINCE qualifier specifies that you wish to set the 
protection only on files created on or since the date given. 


/ THROUGH: dd-mmm-yy 


The /THROUGH qualifier specifies that you wish to set the 
protection only on files created on or before the date given. 


/ SINCE: dd-mmm-—yy/THROUGH :dd-mmm-yy 


The /SINCE and /THROUGH qualifiers can be combined to specify 
that you wish to set the protection only on files created within 
that range. 


/ TODAY 
The /TODAY qualifier specifies that you wish to set the 


protection only on files created on the same day the command is 
being issued. 
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/ EXCLUDE: filespec 


The /EXCLUDE qualifier specifies that you wish the SET PROTECTION 
command not to affect certain files. The filespec argument to 
/EXCLUDE can contain wildcards, but the version number must be 
given, either explicitly or as a "*" wildcard. 


Examples 


2 SET 
FUNCTION? FROTECTION 

CODE? (SYSTEMIRWED: OWNERS RWED> GROUP» WORLD} 
*File(s)? SANTONE.TEX 


~TIRECTORY /FULL SANTOME, TEX 
Tirectory DRLiC303°S 1 


o-JUL-82 19749 
SANTONE. TEX? 1 f1074S2,115 eels 4-JUL-82 9749 
C30375] CRUED + RWED: +9 


Total of 2.4/5. blocks in i. fils 


This example sets file protection so that privileged users and 
the owner have full access to the file and all others have no 
access to the file. The DIRECTORY/FULL command displays’ the 


protection of files. The list is in the same order as before: 
SYSTEM, OWNER, GROUP, WORLD. The commas separate the access 
rights of each group. The commas with nothing following them 


Signify no access for other users with the same group number and 
no access for WORLD. 


>SET PROTECTION *.*;* (SYS:RWE, OWN: RWE,GRO: RW,WOR:RW) 


This example sets the protection for all files in the current 
default directory. No class of user can delete the files in the 
directory; other nonprivileged users cannot extend files in the 
directory. 


Notes 


Although you can protect your files against access by privileged 
users, privileged users can change the protection status of any 
file. Thus, you can prevent privileged users or the system from 
inadvertently accessing your files, but you cannot prevent them 
from changing the protection status and doing what they will with 
your files. 


Other commands accepting a protection code include INITIALIZE, 
MOUNT, and CREATE/DIRECTORY. 


If you deny READ access to a task image file, the task cannot be 
run. 


CHAPTER 5 


HANDLING DEVICES AND VOLUMES 


Peripheral devices are the actual hardware elements that, with the 
computer, make up a computer system. In general, a peripheral device 
is anything that is not part of the CPU or main memory. 


All input to the system and output from it is handled by peripheral 


devices. One primary function of the operating system is to manage 
efficiently all the peripheral devices in the system. 


System generation informs the Executive which devices are to be 


included in your installation and describes the characteristics of 
those devices. 


In RSX-11M/M-PLUS terminology, a file 1S an owner-named area on a 
volume. A volume is a collection of files or data stored ona 
magnetic medium, such as a disk, DECtape, or magnetic tape. This 
medium must be physically placed on a drive and logically mounted 
before the system can access the data on the volume. 


This chapter briefly introduces the important concepts concerning 
devices and volumes. In addition, the chapter describes the DCL 
commands that deal with devices and volumes. 


5.1 DEVICES ON RSX-11M/M-PLUS SYSTEMS 


Table 5-1 lists the devices found on RSX-11M/M-PLUS' systems. Each 
installation has a different mixture of physical devices. Each 
physical device has an associated hardware controller, which serves as 
an interface between the device hardware and the CPU. In addition, 
each device has a device driver, which is the software interface 
between the operating system and the device controller. 


The table also lists pseudo devices found on RSX-11M/M-PLUS systems. 
A pseudo device is an entity treated as an I/O device by the user or 
system although it is not actually any particular physical device. A 
pseudo device name is a pseudonym through which actual physical 
devices can always be reached. See Table 5-2 and Section 5.1.2.1 for 
more information on pseudo devices. 


Individual devices are identified by a two-letter mnemonic and an 
octal unit number, terminated by a colon. If you omit the unit 
number, the system defaults to unit number 0. That is, if you wish to 
specify DBO: in a command, DB: will do. 
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Table 5-1 


Devices on RSX-11M/M-PLUS Systems 


Mnemonic Device Hardware Controller 
AD: | Analog-to-Digital Converter! ADO1-D 
AF: Analog-to-Digital Converter! AFC11 
AR: Laboratory Peripheral Subeyet eit an AR1L 
BS: ~DTO7 UNIBUS Switch¢ © Piet S “DpTO7. 
CL: Console Listing Pseudo Device N/A 
Co: Console Output Pseudo Device N/A 
CR: Card Reader CR11/CM11 
Crs Cassette (TU60) TAL) 
DB: RP04/05/06 disk packs RH11/RH70 
DD: DECtape II (TU58) DL11 
DK: RKO5/J/F cartridge disk RK1l 
DL? RLOL/RLO2 disk drives RL11/RL211 
DM: RK06/07 cartridge disk RK611/RK711 
DP: RP02/03/RPRO2 disks RP1ll 
DR: RM02/03/05 disks and RM80/RP07 RH11/RH70 
fixed media 
DS: RS03/04 fixed-head disks RH11/RH70/RS03/RS04 
DT: DECtape (TU56) TCl1l 
DU: RA60/80/81/RC25/RCF25/RD51/RX50 disks UDA50/RQDX1 
Dx RX0O1 floppy disk RX11 
DY: RX02 floppy disk RX211 
EM: Non-Rotating Electronic Memory _ ML11 
GR: Graphics Display Processor and Scopel VT11/VS60 
IC: Industrial Control System] ICR/ICS11 
Ti: Interprocessor Interface2. DIP-11 
IP: Industrial Control System IP11/IP300 
IS: Industrial Control Subsystem! DRS/DSS11 
LA: Laboratory Peripheral Accelerator LPAIL1-K 
LB: System Default Pseudo Device N/A 
LP: Line Printer LA11/LP11/LS11/LV11 
LS: Laboratory Subsystem! — LPS11 
LT: Parallel Communications Link? PCL-11B 
LR: Parallel Communications Link PCL~11B 
MF: TU78 magtape a ei foccnt ets, aes RH70/TM78 
MK: MKA11 Programmable Memory Box2 MKA11 
MM: TU45/TU1L6/TE16/TU77 magtapes RH11/RH70/TMO2/TMO3 
MS: TS11/TSVO5 magtape TS1:1: 
MT: TSO03/TU1LO/TELO magtapes TM11/TMAL1/TMB1L 
NL: Null Device N/A 
PP: Paper Tape Punch PC11L 
PR; Paper Tape Reader PC11/PR11 
RD: “Reconfiguration Driver? N/A 
SP: . Spooling Pseudo Device2 N/A 
S¥: User Default Pseudo Device N/A 
Tr: Terminal Input Pseudo Device N/A 
TT: Terminal | DH11/DL11/DJ11/D2Z11 
UD: “Universal Digital Controller! uDC11 
VT: Virtual Terminal? N/A 
WK: Workfile Pseudo Device N/A | 
XB: Interprocessor Link! DA11-B 
XL: Intreprocessor Link! DLI1-E 
XM: Interprocessor Link DMC11 
XP: Synchronous Inter facel DP1L 
XQ: Synchronous Interfacel DQ11 
XU* Synchronous® Interfacel DULI 
XWs ‘Synchronous. Interface DUPLL 


1. Indicates device on. RSX-11M only. 
2. Indicates: device on. RSX-11M-PLUS only. 
N/A Controller not applicable to device. 
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RSX-11M/M-PLUS systems support a variety of devices. The terminal, 
line printer, disk, and tape unit are the most commonly encountered. 
The card reader and line printer are called unit record devices. 


Disks and magnetic tapes are mass-storage devices. Disks are 
random-access devices and magnetic tapes are sequential-access 
devices. Each of these device types is discussed briefly in this 


section and, if necessary, in more detail elsewhere in this chapter. 


Devices are informally identified by the two-letter mnemonic 
identifying the device driver, such as DT: for DECtape I, but you 
should remember that the driver may support more than one device. For 
instance, the DL: driver supports both RLO1l and RLO2 devices. 


Unit record devices operate on data one record at a time. Unit record 
devices can store only one record's worth of data at a time. For 
instance, a line printer (LP:) receives and stores characters until it 
has a full line and then prints that line. Unit record devices on 
RSX-11M/M-PLUS include the paper tape punch (PP:), paper tape reader 
(PR:), the TU60 cassette (CT:), and card reader (CR:). 


For storing large amounts of data, disks and tapes are used. These 
disks and tapes are called magnetic media. The information stored on 
these media must be arranged in formats suitable to the operating 
system and your installation's software. 


On RSX-11M/M-PLUS systems, the information contained on the magnetic 
medium is called a volume. Volumes can be of several varieties. 
Foreign volumes are those on which the data is organized along 
principles not recognized by RSX-l11M/M-PLUS systems. Files-11l volumes 
are those on which the data is organized according to the normal file 
structure used by RSX-11M/M-PLUS systems. Devices that accept media 
containing Files-1ll volumes are all disk devices, including floppy 
disks. and disk packs (DB::, DF!, DKt, DLi,;. DPt,; DRe, DS:, DU:, Dx:, and 
DY:), the TU56 DECtape I (DT:), and the TU58 DECtape MII (DD:). 
Files-11 volumes are created through the INITIALIZE command (Section 
5.8). The operating system treats all Files-1ll volumes identically, 
regardless of the device or medium. 


NOTE 


DECtapes are random-access devices. 
Therefore, in this manual and _ other 
system documentation, the term "disk" 
includes DECtapes and the term "magnetic 
tape" excludes DECtapes. 


Files-11 volumes must be mounted (using the MOUNT command, Section 
5.6) for the system to access them. Mounting a volume brings ina 
task called an Ancillary Control Processor (ACP), which serves as an 
interface between system and user tasks and the device driver, and 


maintains the Files-1l structure on the disk. This ACP is called 
FLIACP. 
Magnetic tapes are a sequential-access medium. Random-access media, 


such as disks, are used where speed is the most important virtue. 
Magnetic tapes are used where economy and transportability are more 
important than speed. 
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Magnetic tape volumes are of two kinds, labeled and unlabeled. 
Labeled magnetic tape volumes are accessed through the magnetic tape 
ACP (MTAACP) and conform to the American National Standard for 
Magnetic Tape Labels and File Structure for Information Exchange (ANSI 
X3.27-1978). Labeled magnetic tapes are sometimes called Files-ll 
magnetic tapes, but this is an inaccurate term; the better term is 
labeled magnetic tapes or ANSI magnetic tapes. You can create labeled 
magnetic tape volumes through the INITIALIZE command (Section 5.8). 
Unlabeled magnetic tapes are in a nonstandard format and require that 
you have special software to handle them. Unlabeled tapes must be 
mounted using the /NOLABEL qualifier. 


Laboratory and industrial devices are often encountered in 
process-control environments, particularly on RSX-1IM systems. These 
devices include analog-to-digital converters (AD:, AF:), the 


laboratory peripheral subsystem (AR:), the graphics display processor 
(GR:), industrial control systems (IC:, IP:, IS:), laboratory devices 
(LA:, LS:), and the universal digital controller (UD:). 


Several physical devices are used by the system in its operations. 
There are communications devices, including parallel communications 
links (LT:, LR:), interprocessor links (XB:, Kit» XM:), and 
synchronous interfaces (XP:, XQ:, XU:, XW:). There are system control 
peripherals not normally accessed by users (BS:, MK:, II:). 


Finally, there are the pseudo devices, a general term used to identify 
a number of system features implemented either through device drivers 
without associated hardware or through logical device names. The 
pseudo devices include CO:, CbL:, LB:, NL:, RD:, SY¥:, TiI:, VT:, and 
WK:. See Section 5.1.2.1. 


S.1.1 Yolum 
Since the information in the volume must be on some medium and_ since 
that medium must be physically loaded on a device drive, the device 
driver mnemonic sometimes denotes the device itself and sometimes it 
denotes the volume. For instance, if you have files on a volume to 
which you wish to have private access, you take the following steps: 


1. Check with SHOW DEVICES dd: to see which devices of the type 
you wish to use are available. The type you wish to use is 
determined by the magnetic medium the volume is on. 


2. Make the device your private device through the ALLOCATE 
command. 


3. Physically place the magnetic medium on the device drive. 
(This may be done for you by your system operator.) 


4, Mount the volume through the MOUNT command. 


If. the device you choose is DKl:, both the ALLOCATE and the MOUNT 
command refer to DKl:. In the ALLOCATE command, DKl: is the device 
itself, while in the MOUNT command, DK1: is the volume. In most 
cases, this distinction is not important, but you should understand 
that the expression ddnn: refers sometimes to a physical device and 
sometimes to a volume on the device. 
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5.1.2 Physical Devices, Pseudo Devices, LUNs, and Logical Names 


The purpose of devices of any kind is to handle I/O from _ tasks. 
RSX-11M/M-PLUS systems offer you a number of ways to name and access 
physical devices. In addition to direct access to the physical 
devices by naming them in commands or file specifications, there are a 
number of forms of indirect access to physical devices. 


The operating system often accesses physical devices as _ pseudo 


devices. Tasks access physical devices through logical unit numbers 
(LUNS) that establish a relationship between the I/O done by the task 
and the devices on the system. Finally, you can give any physical 


device a logical name. 


5.1.2.1 Pseudo Devices 


The names of pseudo devices are pseudonyms used by the system to 
access physical devices. System tasks are built to reference various 
pseudo devices. When the system is generated, the pseudo device names 
are associated with the physical devices that are actually present on 
the system. For instance, the system uses pseudo device LB: to refer 
to the disk location of the system libraries. At one installation, 
this might be DR2:, while at another, this might be DB7:, but whatever 
the actual physical device involved, the name LB: will always refer 
to the current disk location of the system libraries. 


Pseudo devices are implemented in several ways. Some pseudo device 
names are really only logical names. No system data structures are 
associated with logical names other than an entry in the system's 
Logical Unit Table (LUT). Other pseudo device names are implemented 
through redirection from one physical device to another. Redirection 
requires more system data structures: a Device Control Block (DCB) 
and a Unit Control Block (UCB). Finally, some pseudo device names are 
implemented through device drivers, which require not only full data 
structures but also the presence of the driver. 


“One pseudo device, MK:, foun RSX-11M-PLUS only, also requires the 
presence of certain hardware. Thus, the term pseudo device does not 
refer to a single form of software, but rather to the concept that a 
usable device name is known to the system regardless of the 
installation's device configuration. 


Table 5-2 summarizes the pseudo devices on RSX-11M/M-PLUS'~ systems. 
Pseudo device CO: is handled differently depending on whether the 
system includes Console Logging. Without Console Logging, CO: is 
redirected, usually to the main operator's terminal, often TTO:. 
Including Console Logging means a driver called CO: is used. This 
driver permits your system manager to send system console output to 
any device or to a file. See the RSX-11M/M-PLUS System Management 
Guide for more information on Console Logging. 


Pseudo device CL:, the Console Listing pseudo device, is commonly 
redirected to LPO:, the system line printer. 


LB:, the Library pseudo device, is the disk on which the system UFD is 
located. 


On RSX-11M-PLUS systems, the library UFD is also on pseudo device LB:. 
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Table 5-2 
Pseudo Devices on RSX-11M/M-PLUS 


Device How 
Name Implemented Hardware? Comments 
Co: Redirection No Console Logging 
CO: Driver Console Logging present 
CL: Redirection 
LB: Redirection 
NL: Driver 
‘SP: Redirection SN SE OMS BLUS only 
SY: Assignment User default device 
TT Dynamic 

Redirection 
VT: Driver eA E M-PLUS. only 
WK: Assignment 
dd: Driver Yes Physical devices 


Pseudo device MK: is implemented through irédicection for internal use 
on RSX-1LIM-PLUS: systems and requires: certain hardware to be present. 


Pseudo device NL:, the null device, is implemented through the NL: 
driver. Program testing often requires an available input or output 
device. The NL: pseudo device can be used for either of these 
purposes. 


For instance, if you are testing a program that normally generates 
large amounts of output, you can assign the appropriate LUN to NL: 
rather than wasting paper or disk space. The system discards output 
sent to NL:. On the other hand, if you are testing a program that 
ordinarily receives input from a device or file, NL: can generate 
usable input without any other source. When a task reads from NL:, 
the driver returns IE.EOF, the code for end of file. When ae task 
writes to NL:, the driver returns IS.SUC, the code for success. 


“Pseudo ‘device RD: is the Reconfiguration Driver found on RSX-11M-PLUS 
systems only. oes Sena an ad By se ee cr ee 


“Pseudo. device SP: is. used by. the Queue Manager. BONS spooling and 
_ implemented | through. redirection, © BR iG pe a ee 


Pseudo device SY: is the logical name applied to the user's default 
or “home" device. This logical name is usually established by the 
LOGIN command and ACNT, the Account File Maintenance Program. This 
names the device to which all commands that do not specify a device 
name default. You can display your default device with the SHOW 
DEFAULT command. You can change your default device with the SET 
DEFAULT command or with the ASSIGN command. 
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Pseudo device TI: is always your terminal, regardless of its number 


or type. If you are logged in on two terminals, you have two TI:s. 
TI: is dynamically redirected on a per-command basis to your current 
terminal. TI: stands for terminal interface. 


On. “RSX-11M- PLUS systems, the. EME driver is used for virtual terminals. 
pores te batch ‘processing. 52 Oras ee en pet tan ee 


The WK: workfile pseudo device is used by a number of system tasks. 
WK: is named by assignment. 


NOTE 


Users can also assign logical names to 
devices {see the ASSIGN command, Section 
Be 2) 4 redirect devices (see the 
ASSIGN/REDIRECT command, Section 5.2.1), 
and write drivers (see the RSX-11M Guide 
to Writing an I/O Driver or the 
RSX-11M-PLUS Guide to Writing an I/0 
Driver). —- —_ 


5.1.2.2 LUNs 


Each task includes logical unit numbers, or LUNS, which establish a 
relationship between the I/0 done by the task and physical device 
units. This relationship can be different for each task. 


Tasks may have from 0 through 250 LUNs. The maximum number of LUNs is 
set when the task is linked. 


LUNS can be assigned or reassigned in three ways: 
e Any user can specify the ASG option at link time. 


e Privileged users can use ASSIGN/TASK (Section 5.2.2) to change 
the LUN assignments in an installed task. 


e The task can include the ALUNS Executive directive (or CALL 
ASNLUN from FORTRAN) to change LUN assignments during 
execution. 


The Task Builder defaults build a task with six LUNs. The default 
assignments are as follows: 


Device LUN 


SY0: 1 
SY0: 2 
SY0: 3% 
SY0: 4 
TIO: 5 
CLO: 6 


This means a task linked with the default LUN assignments’ can 
simultaneously refer to up to as many as six files. Of these files, 
four can be on SY¥:. In this case, SY: is logical device name SY: as 
discussed in the previous section. Further, one file can be on pseudo 
device TI:, meaning that the terminal initiating the task can be used 
to communicate with the task. And finally, one file can be on pseudo 
device CL:, meaning that the task can send output to the console 
listing device, which is usually a line printer or hard-copy terminal. 
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Although the association of LUNS with physical or pseudo devices is 
established at link time, the actual assignment is not done until the 
task is installed, either explicitly, or through the 
install-run-remove form of RUN. 


Once the LUN is assigned, a task can map directly to a device without 
having to search device tables for the physical device. The LUN is 
simply a name used to represent the relationship between the logical 
device name and the physical device. 


LUN assignments are established on a task-by-task basis, in contrast 
to assignments through the privileged ASSIGN/REDIRECT command, which 
apply to all tasks using a device. 


- s 


5.1.2.3 Logicai Device Names 


Logical device names provide a means by which tasks can maintain 
device independence. Logical device names have the same syntax as 
other device names, that is, ddnn:. The 2-character device name can 
be the same as a standard RSX-11M/M-PLUS device or pseudo device, such 
as DK: or LB:, or it can use two letters with an arbitrary meaning, 
such as AZ:. 


When you run a task that refers to a device by a logical name, first 


use the ASSIGN command to assign that logical name to the device. See 
Section 5.2. 


There are three types of logical device assignment: 


e Local assignments, which can be made by any user, apply only 
to tasks initiated from the terminal used to make the 
assignment. Local assignments override both other catcegorics 


of assignments. Different users can assign the same local 
logical name to different devices. 


e Login assignments, which can be controlled only by privileged 
users through ACNT, the Account File Maintenance Program. 
Login assignments are reestablished each time the user logs 


in. Login assignments can also be established through 
ASSIGN/LOGIN, a privileged command. Login assignments 
override the next category, global assignments. Login 


assignments apply only to systems with multiuser protection. 
Login assignments remain in effect until the user logs off or 
until a privileged user deassigns them. 


e Global assignments, which can be made only by privileged 
users. Global assignments apply to all tasks running in the 
system. 


The Executive keeps a logical unit table that records all logical 
assignments and their types. Each time a task assigns a LUN, the 
Executive refers to this table before checking the list of physical 
devices and pseudo devices. Thus, a logical name found in the table 
has precedence over a physical device unit having the same identifier. 
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5.1.3 Public, Shared, Private and Unowned Devices and Mounted Volumes 


In general, no access to magnetic media on RSX-11M/M-PLUS systems is 
permitted without a MOUNT command. If a disk volume is in Files-1ll 
format, MOUNT grants access to the file system through the Files-1l 
Anciliary Control Processor (FLI1ACP). If the information on the 
medium is in some other format, or is unformatted, MOUNT/FOREIGN 
bypasses the ACP and the file system. (MOUNT/FOREIGN is required for 
foreign volumes on RSX-11M-PLUS. MOUNT/FOREIGN is not required but is 
recommended on RSX-11M. See Section 5.6). Use MOUNT/FOREIGN when 
initializing a volume or to use a custom ACP. 


Four categories of device ownership are supported on multiuser 


protection systems: Devices can be public, shareable, private, or 
unowned. Public devices are accessible to all. Within the limits of 
volume protection and file protection, shareable devices are 
accessible to all users who have mounted the device. Volumes on 


private devices are accessible only to the owner of the device. 
Volumes on unowned devices are accessible to no one on RSX-11M-PLUS. 
Volumes on unowned devices can be accessed on RSX-11M. 


Volume protection and file protection can greatly alter your rights of 
access to a particular volume or file. See Section 4.1.5 for more 
information. 


1. Public devices are accessible to all users; access is 
allowed automatically. Only a privileged user can set a 
device public. Devices are set public through the /PUBLIC 
qualifier to the SET DEVICE command (Section 5.10.2) or the 
/PUBLIC qualifier to the MOUNT command (Section 5.6). A 
public device cannot be mounted by any other user. The 
MOUNT/PUBLIC command sets the device public and deallocates 
it if it has been allocated. (An allocated device is a 
private device.) 


2. Shareable devices are accessible to all users who mount the 
volume. A device is made shareable through the /SHAREABLE 
qualifier to the MOUNT command. (Section 5.6) Nonprivileged 
users muSt know the volume label in order to mount the 
volume. Any number of users can mount the volume. It will 
remain mounted until the last user to mount the volume has 
dismounted it. You cannot mount a public or private device 
shareable. 


3. Private devices cannot be accessed by anyone but the owner, 
that is, the person who allocated the device. Devices can be 
made private with the ALLOCATE command (Section 5.4), or by 
the /NOSHAREABLE qualifier to MOUNT, which also allocates the 
device. The DISMOUNT command will deallocate the device. 


Users make devices private to prevent any other user from 
accessing the mounted volume. Any user can allocate a 
device, but your installation may have restrictions on _ the 
practice. 


4, Unowned devices are those that have not been allocated, 
mounted, or set public. 


RSX-11M systems permit limited access to unowned volumes, but 
such use is not advised. See the discussion under the 
/FOREIGN qualifier to MOUNT (Section: 5.6). 


RSX-11M-PLUS permits no access. to unowned volumes. 
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5.1.4 How to Prepare a Scratch Disk for Use 


A scratch disk is a blank disk or one on which the data is of no use. 
The prime example of a scratch disk is one that has never been used. 
Several system utilities and DCL commands are combined to prepare the 


scratch 
process. 


1. 


2. 


disk as a Files-1ll volume. This section summarizes the 


Allocate an appropriate device and place the disk on _ the 
drive. Make sure the device is write-enabled. 


After physically placing the disk on its drive, spin it up 
and mount it using the /FOREIGN qualifier. This permits the 
system to access the disk but bypasses the file system. This 
step. “is. optional . on. RSX-LIM systems but required on- 


‘RSX-1IM-PLUS. 


You may need to write sector and timing information about the 
physical blocks on the disk. In most cases, disk formatting 
is done by the manufacturer, but some disks are shipped 


unformatted. If you have any question about formatting a 
disk, see your system manager. 


If formatting is necessary, you can use FMT, the Disk Volume 
Formatter Utility. Full information on this utility is given 
in Chapter 5 of the RSX-11M/M-PLUS Utilities Manual. To gain 
access to FMT from DCL, enter the command: 


>RUN SFMT 
FMT 


Now you can enter FMT commands. 


After you have a formatted disk, you must identify the _ bad 
blocks on the disk. These are blocks that are physically 
unusable for some reason. This information is often written 
on disks when they are manufactured, but you can supplement 
this information with BAD, the Bad Block Locator Utility, 
described in Chapter 6 of the RSX-11M/M-PLUS Utilities 
Manual. In fact, FMT provides access to BAD, but you can 
also run BAD with the following command: 


>RUN SEAL 
BAL: 


Once you have a formatted disk with identified bad blocks, 
the disk driver and the disk controller have full use of the 
disk. In most cases, your scratch disk will already have 
formatting and bad-block data in place. Now you must provide 
the information that the file system needs to use the disk. 


This information is provided through the INITIALIZE command. 
Qualifiers to INITIALIZE permit you to set up your volume for 
the most efficient use by the system. The defaults for 
INITIALIZE produce a standard volume. 


INITIALIZE writes a Volume Home Block, which contains 
information for the system about the initialization, 
including the volume label that is used to control access’ to 
the volume by nonprivileged users. 
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INITIALIZE also creates five files used by the system to 
locate or create other files on the volume. Here are brief 
descriptions of these files: 


File Description 


000000.DIR This is the Master File Directory (MFD). 
It is a file that contains a list of User 
File Directories (UFDs). The UFDs contain 
pointers to all named files on the volume. 


INDEXF.SYS This is the volume index file, which 
contains file-control information, such as 
file protection, creation date, the 


physical location of the file on the 
medium, and other information needed _ for 
the system to access the files on the 
volume. 


BADBLK.SYS This is the bad-block file. All unusable 
blocks are included in this file. Any 
block that is included in a file is 
unavailable for any other use. 


BITMAP.SYS This file contains information on all 
blocks used and free on the volume. The 
information is in the form of one bit for 
every block. If a block is used, the 
corresponding bit is set. 


CORIMG.SYS This is the operating system checkpoint 
file. It is included on every volume. If 
the volume is not to provide Lor 
checkpointing, the checkpoint file is zero 
blocks long. 


6. Once the volume is initialized, it is no longer foreign. You 
must dismount it and mount it as a Files-1ll volume. Use this 
sequence of commands: 


>DISMOUNT ddnn: 
>MOUNT ddnn: volumelabel 


Now the volume is a Files-1l volume. The file system has full access 
to the volume through a DIGITAL-Supported ACP. If your system has a 
custom ACP for any device, you must mount the volume foreign and 
specify the ACP. 


You can alter some of the data placed in the Volume Home Block by 
INITIALIZE by using the INITIALIZE/UPDATE command. See Section 5.8.1. 


Certain system functions may also require that the volume be mounted 
foreign without specifying an ACP. You should check the appropriate 
documentation to be sure. This requirement may arise with the 
following DCL commands: 


@ BACKUP, Section 5.9 


@e INITIALIZE, Section 5.8 
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This requirement may also arise with the following utilities, 
described in the noted chapter of the RSX-11M/M-PLUS Utilities Manual: 


e FLX, File Transfer Utility, described in Chapter 4 
e FMT, Disk Volume Formatter Utility, described in Chapter 5 
e BAD, Bad Block Locator Utility, described in Chapter 6 


e BRU, Backup and Restore Utility, described in Chapter 7, and 
accessed from DCL through BACKUP, Section 5.9 of this manual 


@e DSC, Disk Save and Compress Utility, described in Chapter 8 


e VFY, File Structure Verification Utility, described in Chapter 
9 


e DMP, File Dump Utility, described in Chapter 11 


5.1.5 How to Prepare a Scratch ANSI Magnetic Tape for Use 


1. Allocate an appropriate device and place the tape on _ the 
drive. Make sure the device is write-enabled. 


2. After you have physically placed the tape on the drive, mount 
the tape using the /FOREIGN qualifier. This permits the 
system to access the tape but bypasses the file system. This 
step. .is optional. on. RSX-11M systems but» required on 
RSX-1LIM-PLUS. + 


3. Now you must provide information that the file system needs 
to use tne tape. inis is done througn tne INITIALIZE 
command. Qualifiers to INITIALIZE permit you to set up your 
volume for the most efficient use by the system. The 
defaults for INITIALIZE produce a standard ANSI magnetic tape 


volume. 


INITIALIZE writes an ANSI volume label, which contains’ the 
File Set ID and also creates a dummy file. This dummy file 
is overwritten when the first user file is written to the 
tape. 


There are no UFDsS in the ANSI magnetic tape structure. See 
the IAS/RSX-11 I/O Operations Reference Manual for more 
information on ANSI magnetic tapes. 


4. Once the volume is initialized, it is no longer foreign. You 
must now dismount the volume and remount it as an ANSI 
volume, using DISMOUNT and then MOUNT, this time without the 
/FOREIGN qualifier. 


5.1.6 Summary of Device and Volume Use Commands 


All Files-11 volumes and ANSI and unlabeled magnetic tapes must be 
mounted for any access. 


All other volumes are considered foreign volumes. Foreign volumes are 
normally mounted with the /FOREIGN qualifier to MOUNT. 


On RSX=-11M, you are not required to mount foreign volumes, but if you 
do not, the system and other users. have unlimited access to the 
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ASSIGN 


volume, as: it is considered unowned. MOUNT/FOREIGN is recommended for 
most use of “foreign volumes on RSX-11M. 


On “RSX=11M-PLUS, you: 
“required for “all. use. 
i Methane rde Crean en ko Ne 


Multiple users can mount a volume on a shareable device. The volume 
remains mounted until all users who have mounted it dismount it. 


Ownership of a device on a system with multiuser protection is of four 
kinds: 


e A volume on a private (allocated) device can be mounted by the 
owner only. 


e A volume mounted /SHAREABLE by the first user to mount it can 
be mounted by any other user who knows the volume label. The 
volume stays mounted until the last user to mount it dismounts 
it. 


@e A volume on a public device is usually mounted after the 
device is set public. The system owns public devices. 
Mounting a public device means other users can access’ the 
device without mounting it. Only a privileged user can seta 
device public or nonpublic. Public devices cannot be 
allocated. 


@e A volume on an unowned device can be mounted by anyone. 


Any user who mounts a volume has full access to that volume within the 
limits of privilege and volume and file protection. Privileged users 
have privileged access. Nonprivileged users have nonprivileged 
access. Nonprivileged users have privileged access to volumes mounted 
on their private (allocated) devices. 


A mounted device cannot be set public or nonpublic, and cannot be 
allocated or deallocated. 


LOGOUT issued by any user automatically dismounts any volumes mounted 
from that terminal and deallocates any devices allocated from that 


terminal. A mounted public device is not dismounted by LOGOUT, 
however. 


5.2 ASSIGN 


ASSIGN associates a logical name with a physical device, pseudo 
device, or other logical device. All references to the logical name 
are resolved by the system to the associated physical device, pseudo 
device, or logical device. 


Format 
ASSIGN [/qualifier[s] ] 
Device? ddnn: 


Logical device? logicalddnn: 


ASSIGN[/qualifier[s]] ddnn: logicalddnn: 
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Command Qualifiers 


/LOCAL 

/LOGIN 

/GLOBAL 
/SYSTEM 
/TERMINAL:ttnn: 


Parameters 


ddnn: 


Specifies the name of the physical device, pseudo device, or 
logical device that is to receive the logical name. 


logicalddnn: 


Specifies the logical device name tod be given to the physical 
device, pseudo device, or logical device. 


The logical device name consists of a 2-letter mnemonic followed 
by an octal number terminated with a colon (:). There is no 


restriction on logical device names. They may use standard 
device mnemonics, such as DKO: or SP0:, or random letters, such 
as AZ1l:. 


Command Qualifiers 


STOCAE. 


Specifies that the assignment is to be a local assignment. This 
is the default qualifier. It need not be specified. Commands 
and tasks initiated from your terminal can access devices through 
the logical names assigned to them. No automatic deassignment 
occurs when you dismount the device. Any terminal can define its 
own set of local assignments. The terminal defining the local 
assignments is the only one for which the logical devices exist. 


/LOGIN 


Specifies that the assignment is to be a login assignment. This 
is a privileged qualifier. 


Login assignments occur only in systems that support multiuser 
protection. When a user issues a LOGIN command to log in to the 
system, the system automatically assigns the logical name _ SyY0: 
to the user's system device, which is the device that contains 
the user's files. Login assignments are usually established 
through ACNT, the Account File Maintenance Program. ASSIGN/LOGIN 
does not alter the account file. 


/GLOBAL 
/ SYSTEM 


Specifies that the assignment is to be a global assignment. This 
is a privileged qualifier. /SYSTEM is a synonym included for 
VAX/VMS compatibility. 


Global assignments apply to all tasks running in the system. 
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ASSIGN (Cont.) 


Specifies that the requested local assignment be applied to 
another terminal. Only a privileged terminal may make 
assignments to other terminals. RSX-11M-PLUS only. 


Examples 
~ASSIGH 
Tlevice? Ris 
Logicel device? TFL: 
This example assigns the logical name TPl1: to the physical 


device DBl:. The user may now issue commands referring to device 
TPl: in any command that accepts a device specification and DB1: 
will be substituted for it. 


SASSION LBOS BS 


This example assigns the logical name RR2: to the pseudo device 
LBO:. 


PAS SIGN/TERMINAL 37 


9S EM Lae “the pied oa 
tasks. tiieiated from TT2255. 


sPee teat serminay. 


‘This example assigns 
device DB1l: bikes ame 
‘This ¢ommand~ must ~ 

RSX-11M-PLUS . only. | 


hASSIGN/SLOBAL DRG xed: 


This example assigns the logical name XxXl1: to the physical 
device DK1l:. All users and tasks on the system can refer to XXL: 
when they initiate commands and tasks. This command must be 


issued from a privileged terminal. DKl: can also be used to 
reference DKl:. 


Notes 
Local assignments have precedence over both login and global 
assignments. Login assignments have precedence over global 
assignments. When a user deassigns a local logical name, the 
system defaults to any login assignment of the same name. 


You can display current assignments with SHOW ASSIGNMENTS, 
described in Section 5.10.1. 


ASSIGN is counteracted by DEASSIGN. See Section 5.3. 


You can assign SyY0: with SET DEFAULT, described in Section 
4.5.1. : 


ASSIGN/REDIRECT is a separate command, described in Section 
See els 


ASSIGN/TASK is a separate command, described in Section 5.2.2. 
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ASSIGN/REDIRECT 


ASSIGN/QUEUE is a separate command, described in the 


Nee eet creer ne nS 


5.2.1 ASSIGN/REDIRECT 
ASSIGN/REDIRECT redirects output from one physical device to another. 
You can also redirect a physical device to a pseudo device, or vice 
versa. Use this privileged command when a device is unavailable and 
you have another device that can take its place. The devices need not 
be of the same type. 
Format 

ASSIGN/REDIRECT 

From? oldddnn: 

To? newddnn: 

ASSIGN/REDIRECT oldddnn: newddnn: 
Parameters 
oldddnn: 

Specifies the device from which requests have been redirected. 


newddnn: 


Specifies the device to which subsequent requests for oldddnn: 
are to be redirected. 


Example 
SASSIGN/REDIRECT OG; TS: 
“SHOW DEVICES PTYPE TT? 
UTO¢ DTS) LOAne hf 
T1; LOATE t 
0T23 LOADE) 
UTS: LOATLE i 


SASSIGN/RETIRECT 
FROM? [iTO? 


TO? Tos 

=>SHOW DEY [Ts 
UTGs LOATED 
Iti: LOARED 
lt2: LOADED 
T33 LOALIED 


This example shows the process of redirection. Following the 
first ASSIGN/REDIRECT, any output for DTO: is sent to DT3:, as 
indicated by the first SHOW DEVICES display. Later, when DTO0: 
is again available, the user issues ASSIGN/REDIRECT again to 
redirect DT0O: to DTO:. 
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ASSIGN/REDIRECT (Cont.) 


Notes 


Redirection does not affect any I/O requests already in the I/0 
queue. 


The following restrictions apply to this command: 

® You cannot redirect from or to a logical device name. 

@e You cannot redirect from one pseudo device to another pseudo 
device. You can, however, redirect a pseudo device to a 
physical device or vice versa. 

@e You cannot redirect pseudo device TI:. 

@e You cannot redirect an attached or spooled device. 


@ You cannot redirect a device unit containing a mounted volume. 


@ You cannot redirect a logged-on terminal to a device other 
than another terminal. 


Error Messages 


A** 


A*k* 


A** 


Ax** 


-- Circular redirect error 


Explanation: Command attempted to establish a circular list of 
redirections. 


User Action: Check available devices with SHOW DEVICES and set 
up legal redirection list. Reissue command. 


-- Device not redirectable 


Explanation: Command attempted to redirect a device that cannot 
be redirected. 


User Action: Check command for proper device names and reenter. 
-~- New device not known to system 


Explanation: An ASSIGN/REDIRECT attempted to redirect to a new 
device that is not in the current system. 


User Action: Check the devices on the system with SHOW DEVICES. 
Retype the command after checking for proper device names. 


-~- Old device attached 


Explanation: The oldddnn: specified in the command is attached 
or spooled. 


User Action: Find the cause of the error and proceed 
accordingly. 
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ASSIGN/TASK 


A** -~- Old device mounted 


Explanation: The oldddnn: specified in the command contains a 


mounted volume. 
User Action: Wait for device to become available. 


A** -~ Old device not known to system 


Explanation: An ASSIGN/REDIRECT attempted to redirect an unknown 


device. 


User Action: Check devices with SHOW DEVICES. Reenter 
after checking for proper device names. 


A** -- Pseudo device redirect error 


command 


Explanation: Command attempted to redirect a pseudo device to 


another pseudo device. 


User Action: None. You cannot redirect a pseudo device to 


another pseudo device. 


A** -- TI redirect error 


Explanation: Command attempted to reedirect pseudo device TI:. 


User Action: None. TI: cannot be redirected. 


5.2.2 ASSIGN/TASK 


ASSIGN/TASK reassigns an installed task's logical unit numbers 
from one physical device to another. 


The reassignment overrides the static LUN assignments in the 
disk image file. 


This is a privileged command. 
Format 
ASSIGN/TASK 
Task? taskname 
Device? ddnn: 
Logical Unit? lun 
ASSIGN/TASK:taskname ddnn: lun 


Parameters 


taskname 


(LUNs) 


task's 


Identifies the installed task whose LUN you wish to reassign. 
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DEASSIGN 


ddnn: 


Specifies the new device to which you wish the LUN reassigned. 
This can be a physical device, pseudo device, or logical device 


name. 
lun 
Specifies which LUN you wish to reassign to the new device. 
Examples 
PASSIGH/STASKINIRWAN 
levice?r DRI: 
Logical amit? & 
This example overrides the assignment of LUN 5 established at 
link time and reassigns LUN 5 to DB1:. 
SASSIGNSTASKRI PALMAR TLE: 4 
This example overrides the assignment of LUN 4 established at 
link time and reassigns LUN 4 to TTl:. 
“ASSIGM/TASKRIGIVEOGON AZT? 3 
This example overrides the assignment of LUN 3 established at 
link time and reassigns LUN 3 to logical device name AZl:. 
Notes 


ASSIGN/TASK has no effect on a memory-resident task. Thus, this 
command has no effect on currently executing tasks or tasks fixed 
in memory. You can use ASSIGN/REDIRECT for dynamic device 
reassignments. 


Error Message 
A** -~ Lun out of range 


Explanation: Command attempted to reassign a LUN that was higher 
than the maximum number of LUNs allocated during the task link. 


User Action: Issue SHOW TASK: taskname/LOGICAL UNITS to determine 
how many LUNs were allocated. 


5.3 DEASSIGN 


DEASSIGN deletes logical-device assignments. DEASSIGN disassociates 
logical names from physical device names, pseudo device names, or 
logical device names assigned by ASSIGN. 
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DEASSIGN (Cont.) 


Format 


DEASSIGN [/qualifier[s]] 
Logical device? logicalddnn: 


DEASSIGN[/qualifier[s]] logicalddnn: 
Command Qualifiers 


/LOCAL 
/ALL 


/GLOBAL 


/ SYSTEM 
/LOGIN 
/TERMINAL:ttnn: 


Parameter 
logicalddnn: 


Specifies the logical device name, assigned by ASSIGN, that is to 
be deassigned. This is a required parameter except with the /ALL 
qualifier. Logical device names have the same format as all 
other device names, a 2-letter mnemonic followed by an octal 
number terminated with a colon (:). 


Command Qualifiers 


Any other qualifier can be used with /ALL. The /TERMINAL 


‘ 


qualifier can be used with /LOGIN or /LOCAL. 


/LOCAL 


Specifies that a local logical name is to be deleted. This is 
the default. 


/ALL 
Specifies that all assignments of the specified type are to be 
deleted. If this qualifier is used alone, all local assignments 
are deleted. This qualifier can be used with other qualifiers. 

/GLOBAL 

/SYSTEM 
Specifies that a global assignment is to be deleted. / TERMINAL 
may not be specified with /GLOBAL. /SYSTEM is a synonym included 
for VAX/VMS compatibility. 
This is a privileged qualifier. 

/LOGIN 


Specifies that a login assignment is to be deleted. 


This is a privileged qualifier. 
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DEASSIGN (Cont.) 


/TERMINAL:ttnn: 
Specifies that the logical assignment to be deleted applies to 
another terminal. /TERMINAL may not be specified along with 
/GLOBAL. 


Only privileged terminals can delete assignments made from other 
terminals. This qualifier is for RSX-11M-PLUS only. 


Examples 


“TEASSIGN 
Logical device? TFG: 


This example deletes the assignment of logical device name TPO: 
to a device. 
ONS ALL 


This example deletes all local logical-name assignments. 


PTEAS/LOCAL/ ALL 
This example is the equivalent of the previous example. / LOCAL 
is the default qualifier. 

PDEAS/LOCAL/S ALL STERMINALITTE12 


This example deletes all local assignments from terminal MTT21:. 
This command must be issued from a privileged terminal. 


Notes 
DEASSIGN counteracts ASSIGN. 
You must type at least the first four characters of DEASSIGN. 


Login assignments are normally established through ACNT, the 
Account File Maintenance Program. 


You can display assignments with SHOW ASSIGNMENTS. See Section 
56:0 


All local assignments disappear when you log out. 
DISMOUNT does not delete logical name assignments. 


DEASSIGN/QUEUE iS a Separate command, See the RSX-11M/M-PLUS 
Batch and Queue Operations Manual for more details. 


Error Message 
DEA -- Device not terminal 


Explanation: The /TERMINAL qualifier named a device that is not 
a terminal. 


User Action: Retype command after checking proper syntax. 
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ALLOCATE 


5.4 ALLOCATE 
ALLOCATE declares a specified device to be a private device. 
Format 


ALLOCATE [qualifier[s] ] 
Device? dd[nn:] [logicalname] 


ALLOCATE [/qualifier[s]] dd[nn:] [logicalname] 
Command Qualifier 


/TERMINAL:ttnn: 
/TYPE:devicetype 


Parameters 
dd[nn:] 
Specifies the device or device type to be allocated. 


The device name can be entered in one of two forms. 


e If you use the form ddnn:, the specified device is 


allocated, if available. 


e If you use the form dd without the number or the colon, the 
first available device of the specified type is allocated. 


This is called generic allocation. 
logicalname 


Assigns a logical name to the device as you allocate it. 
parameter is optional. 


The logical name must be of the form xxnn:. Logical names 
the same form as device names. The assignment is 
automatically. 

Command Qualifiers 


/TERMINAL:ttnn: 


Allocates the device to the specified terminal. This 
privileged qualifier. 


/TYPE:devicetype 


Specifies the type of device you wish to allocate, Use 


This 


take 
done 


is a 


this 


qualifier with the generic allocation feature. If you issue an 
ALLOCATE command with the device name specified in the form dd 
without unit number or colon, the first available device with the 
name dd is allocated. Since devices with names beginning with DB 


can be RP04s, RPO5s, or RPOG6S, and since the disk packs for 


these 


devices are not compatible, you could do a generic aliocation 


specifying /TYPE:RP04 to allocate the first available RP0O4. 
the examples. 


See 
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Examples 


2ALLOCATE U6 
ALL -- KO? Now sllocated 


This example allocates the first available RKO5 drive. The 
message gives the name of the device allocated. 


This is an example of a generic allocation. 


2ALLOCATE 
tevice? R13 


This example allocates the specified device. The allocation is 
confirmed by the return of the prompt. No message. 


FALL DRL? 
ALL -- fievice ellocaeted to other user 
This example shows an allocation that failed because the device 
named was not available. 
ALL DBS? TRO: 
ALL ~~ DBS: Now alloceted 
This example allocates the specified device and assigns it the 


logical name TPO:. 


>ALLOCATE/TYPESRPO4 DB 


ALL -- DRG! Now sllocetern 
This example shows the use of the /TYPE qualifier. The user 
wished to allocate the first available RP04 but to ignore any 
other devices uSing the DB driver. This is also a_=e generic 


allocation. 


Notes 


When you allocate a device, no other user can gain access to. the 
device. 


DEALLOCATE counteracts ALLOCATE. See Section 5.5. 


If more than one user needs to access a volume on a device, the 
device should not be allocated. Each user should mount the 
volume. It remains mounted until all users who have mounted it 
have dismounted it. 


You cannot include ALLOCATE in RSX- LIM-PLUS batch jobs... See. the 
RSX-11M/M-PLUS~ Batch and Queue Operations Manual” for information 
on private devices in batch jobs. 
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DEALLOCATE 


Error Messages 
ALL -- Device allocated to other user 


Explanation: Command attempted to allocate device already 
allocated by another user. 


User Action: Wait to allocate the device until the other user 
has deallocated it. (The terminal from which the device was 
allocated can be displayed by SHOW DEVICES.) 

ALL -- Device attached 


Explanation: Command attempted to allocate device attached by 
running task. 


User Action: Wait to allocate device until task is finished. 
ALL -- Pseudo device error 


Explanation: Command attempted to allocate a pseudo device. 
Pseudo devices cannot be allocated. 


User Action: Retype command after checking proper device name. 
ALL -- Public device 
Explanation: Command attempted to allocate a public device. 
User Action: Public devices cannot be allocated. 
ALL -- User logged on terminal 


Explanation: Command attempted to allocate a terminal logged in 
by another user. 


User Action: Only terminals that are not logged in can be 
allocated. 


5.5 DEALLOCATE 


DEALLOCATE counteracts ALLOCATE. It frees a private device for access 
by other users. 


Format 


DEALLOCATE [/qualifier] 
Device? ddnn: 


DEALLOCATE[/qualifier] ddnn: 
Command Qualifiers 
/ALL 


/DEVICE 
/TERMINAL:ttnn: 
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Parameter 
ddnn: 
Specifies the device to be deallocated. 


Command Qualifiers 


/ALL 
The /ALL qualifier frees all devices allocated from the terminal 
being used. If you use this qualifier, you cannot specify a 
device name. 

/DEVICE 


This qualifier is a no-op. 
/TERMINAL:ttnn: 


This qualifier enables a privileged user to deallocate devices 
allocated from another terminal. (RSX-11M-PLUS only.) 


Example 


STREALLGCATE 
Device? DRG: 


This example deallocates the device DBO: previously allocated by 
the user. 


Notes 
Nonprivileged users can deallocate only those devices that they 
have previously allocated. Privileged users can deallocate any 
private device. 
DEA is the short form of DEALLOCATE. 

Error Messages 


DEA -- Device allocated to another user 


Explanation: Command attempted to deallocate a device allocated 
by another user. 


User Action: Nonprivileged users can only deallocate devices 
they have allocated from the same terminal. SHOW DEVICES 
displays the terminal from which the device was allocated. 

DEA -- Device mounted 


Explanation: Command attempted to deallocate a mounted device. 


User Action: You cannot deallocate a mounted device. Dismount 
the device. 
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5.6 MOUNT 

MOUNT declares a volume to be logically known to the system, on line, 
and available for use. Some qualifiers can be used with any MOUNT 
command; some are limited to mounting disks (and other 


random-addressable devices), and others are limited to mounting 
magnetic tapes. 


Format 

For Disks and Other Random-Addressable Devices 
MOUNT [/qualifier[s]] ddnn: volumelabel 

For Magnetic Tapes 


MOUNT [/qualifier[s]] ddnn:[,ddnn:...] fileset-ID 


Command Qualifiers for Both Disks and Tapes 


SAVE | 

“a PNOJTUNLOAD 
/FILE PROTECTION: (code) 
/FOREIGN 
/OVERRIDE: IDENTIFICATION 
/PARAMETERS:"user parameters" 
/PROCESSOR:arg 

acpname 

UNIQUE [:acpname] 
/PROTECTION: (code) 
/PUBLIC 
/ [NO] SHAREABLE 
/ [NO] SHOW 
/SYSTEM (Synonym for /PUBLIC) 
/([NO]WAIT 
/({NO]WRITE 


Command Qualifiers for Disks and Other Files-ll Devices 


/ACCESSED:n 
/EXTENSION:n 
/OWNER: [uic] 
/UNLOCK 
/WINDOW:arg 
n 
(USER:n, INDEX:n) 
FULL 
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MOUNT (Cont.) 


Command Qualifiers for ANSI and Unlabeled Tapes 


/BLOCK SIZE:n 
/CARRIAGE CONTROL:arg 


FORTRAN 
LIST 
NONE 
/DENSITY:arg 
800 
1600 
6250 
/ [NO] HDR3 


/ {NO] LABEL 
/OVERRIDE: (arg[,s]) 
ACCESSIBILITY 
EXPIRATION DATE 
SET IDENTIFICATION 
/RECORD SIZE:n 
/TRANSLATE:arg 
EBCDIC 
NONE 
Url 
UT2 
UT3 


/VOLUME IDENTIFICATION: (volume-ID[,volume-ID[,s]]) 


Parameters 


ddnn: 


Specifies device on which the volume is to be mounted. You can 
mount only one disk or other random-addressable device, but you 
can mount several magnetic tapes. See the discussion of mounting 
tapes and tape sets in Section 5.6.1. 


NOTE 


Disks and magnetic tapes differ in the 
way labeling is handled. See the 
separate discussions of volumelabel and 
fileset-ID. See also Section 5.6.1 for 
more on magnetic tape Volume IDs and 
File Set IDs. 


volumelabel 


Specifies the volume label, that is, the name associated with the 
volume. Volume labels are mandatory for nonprivileged users. 
You must supply a volume label for each volume you wish to mount. 
Disk and random-addressable volume labels can be as many as 12 
characters. 


Volume labels (or identifiers) can include any alphanumeric 
character without restriction, and can also include 
nonalphanumeric symbols, including the following: 


<space> ! " &% Ma Ye Re ee eS RS ce 
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Labels including these characters must be enclosed in "quotes". 
If the label includes the quotation mark itself ("), the 
quotation mark must be followed by another quotation mark. The 
extra quotation marks do not count in figuring the length of the 
label. See the examples. 


Note that the at sign (@), semicolon (;), and dollar sign (S$) are 
not accepted in volume labels. 


fileset-ID 


Magnetic tape Volume Identifiers or File Set Identifiers can be 
aS many as six characters in length. By default, the Volume 
Identifier on the first tape named in a MOUNT command is taken as 
the File Set Identifier as well. See the discussion in Section 
5.6.1 for the distinction between magnetic tape File Set 
Identifiers and magnetic tape Volume Identifiers. 


Command Qualifiers 


ifiex is for RSX-11M-PLUS systems only. 
and DU: devices only. 


the: “default eh will Bppily coaben the 
SAVE ee ae muunentne and eee! 


Rehan * these aes est bee (set when you ss 
DISMOUNT. command. See Section 3. Fone : State ae 


Here PaonuCnTONesde) 


Specifies the default file protection for any new files created 
on the volume while it is mounted. The file-protection code is 
enclosed in parentheses. See Section 4.1.5 for more information 
on file-protection codes and the relationship between file 
protection and volume protection. See also the /PROTECTION 
qualifier to MOUNT. 


The default file protection can be overridden by specifying 
another protection when the file is created. 


If this qualifier is not included, the value specified at the 
time the volume was initialized is appiied. 


For ANSI magnetic tapes, this qualifier specifies the protection 
applied to the volume. See the RSX-11M/M-PLUS I/O Operations 


Manual for further information on the translation from this 
coding to ANSI label coding. 
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/ FOREIGN 


Specifies that the volume being mounted is not in Files-1ll 
format. Such volumes are called foreign volumes. Note that 
before a disk or tape has been initialized, it is a foreign 
volume. This qualifier functions slightly differently on RSX-11M 
and RSX-11M-PLUS. 


On. RSX=11M,: /FOREIGN -is: recommended but not required for mounting 
foreign..volumes. If you donot mount. the volume, access to.the 
‘volume is unrestricted. “If you mount a foreign volume — /FOREIGN, 
noone ‘else Can access iE. OTE you include. /FOREIGN when mounting 
‘the foreign volume /SHAREABLE, hen other users must valso...mount 
the “volume to access “1t.0. : ie nN ae 


volumes... 
/OVERRIDE: IDENTIFICATION 


Allows privileged users to mount a volume without using the 
volume label (or the File Set ID for magnetic tape). 
Identification is the default argument for /OVERRIDE. 


If you are mounting a magnetic tape, you may want to combine’ the 
IDENTIFICATION argument with other /OVERRIDE arguments that are 
limited to use with magnetic tape. See the description of 
/OVERRIDE in the magnetic tape section. 


/PARAMETERS:"user parameters" 


Enables you to enter commands to an ACP that is not DIGITAL 
standard. MOUNT/PARAMETERS passes a maximum of 40 characters 
enclosed in quotation marks to a foreign ACP. You must use the 
/FOREIGN and /PROCESSOR qualifiers with this qualifier. If the 
quoted command includes the quotation mark itself ("), the 
quotation mark must be followed by another quotation mark. The 
extra quotation marks do not count in figuring the length of the 
command. 


/ PROCESSOR: arg 
acpname 
UNIQUE [:acpname] 


Allows privileged users to specify the name of the ACP to use to 
support file activity on the volume. In most cases, you can use 
the default ACP. The default ACP depends on the device type. 


If the device is a disk, MOUNT searches for an ACP with a name in 
the form ddnnFl. Failing that, MOUNT searches for an ACP with a 
name in the form ddAACP, and finally, for an ACP named FI11ACP., 
Thus, for an RKO5 device, which uses the device name DK:, MOUNT 
looks first for an ACP named DKnnFl, where nn is the device 
number. If no ACP of that name exists, MOUNT looks for an ACP 
named DKAACP, and finally, for FL1ACP, 
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If the device is a DECtape, MOUNT first looks for an ACP with a 
name in the form ddnnFl. Thus, for a TCll DECtape, which uses 
the device name DT:, MOUNT looks first for an ACP named DTnnFl, 
where nn is the device number. For a TU58 DECtape II, which uses 
the device name DD:, MOUNT looks for an ACP named DDnnFl. If no 
ACP of the appropriate name exists, MOUNT looks for an ACP named 
ddAACP. Failing that, MOUNT seeks an ACP named DTAACP, and 
finally, for the FILI1ACP. 


If the device is a magnetic tape, MOUNT first looks for an ACP 
with a name in the form ddnnFl. Thus, for a TS04 device, which 
uses the device name MS:, MOUNT looks first for an ACP named 
MSnnFl, where nn is the device number. If no ACP of that name 
exists, MOUNT looks for an ACP named MSAACP, and finally, for the 
MTAACP. 


You only have to specify an ACP in special cases. If an ACP has 
been written for a custom application in your installation, you 
will need to use that ACP for volumes used by that application. 
You will also have to include the /FOREIGN qualifier in this 
case. You may also need to use the /PARAMETERS qualifier to 
enter parameters used by that ACP. 


The UNIQUE argument specifies that a dedicated ACP is to be used 
for the volume being mounted. If you do not name an ACP with the 
UNIQUE argument, MOUNT creates a copy of the FI1lACP if the device 
is a disk or DECtape, or of the MTAACP if the device is a 
magnetic tape. This unique ACP will be given a name of the form 
ddnnFl or ddnnace. When the volume is dismounted and the file 
processor exits, the ACP is automatically removed. 


On RSX-11M-PLUS only, if the ACP (FI1ACP or MTAACP) is installed 
in secondary pool, _/PROCESSOR: UNIQUE is the default. re Be 


If you specify the UNIQUE argument naming a foreign ACP, that ACP 
is created and dedicated to your volume. If you name a foreign 
ACP, you need the /FOREIGN qualifier. You may also need _ the 
/PARAMETERS qualifier. 


SYSTEM MANAGERS 


You can control the resources dedicated 
ua] file processing by choosing 
appropriate names for installing ACPs. 
For example, if you wish DBO: to have a 
dedicated ACP and for DBl: and DB2: to 
use a shared ACP, install the FI11ACP as 
DBOOF1 and as DBAACP. 


If you mount a volume /FOREIGN but do not specify an ACP, no ACP 
can access the volume, but tasks such as INITIALIZE, DSC, BAD, or 
user tasks with non-file-structured device QIOs can access’ the 
foreign volume. 
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/PROTECTION: (code) 


Specifies the volume protection for Files-1ll disks. This 
protection overrides the volume protection established when the 
volume was initialized. The /PROTECTION qualifier combines with 
the /OWNER qualifier to control access to the volume. See 
Section 4.1.5 for more information on volume protection. 


/PUBLIC 
/SYSTEM 


These two qualifiers are synonyms. The /SYSTEM qualifier is 
included for VAX/VMS compatibility. 


Privileged. Specifies that the mounted voiume be available to 
all users who are allowed access under the volume-protection and 
file-protection codes established for the volume when mounted. 
See the discussion of file protection and volume protection in 
Section 4.1.5. 


If you state this qualifier explicitly when mounting a volume on 
an allocated (private) device, the device is automatically 
deallocated and set public, if necessary. 


If you do not state this qualifier explicitly, and the device is 
already set public, the mount will default to /PUBLIC. 


See the discussion of public, private, and shareable volumes in 
Section 5.1.3. 


/ [NO] SHAREABLE 
Specifies whether the volume is to be mounted shareable. 


A volume mounted /SHAREABLE can be mounted multiple times by the 
same or different users. See the discussion of multiple mounts 
in Section: 5.143. Each user's access is determined by the 
volume-protection and file-protection codes established for the 
volume when mounted. See the discussion of file protection and 
volume protection in Section 4.1.5. 


If you mount the volume /SHAREABLE and the device is allocated or 
set public, the device is automatically deallocated or set 
nonpublic. 


A volume mounted /NOSHAREABLE is dedicated for your private use. 
No other user can access the volume. For Files-11 volumes 
mounted /NOSHAREABLE, your privileges are SYSTEM privileges. See 
the discussion of file protection and volume protection in 
Section 4.1.5. 


If you specify /NOSHAREABLE explicitly when mounting a volume on 


a device, the device is allocated and set nonpublic, if 
necessary. 


If the device is already allocated, the mount defaults’ to 
/NOSHAREABLE. 


If the device is not allocated or set public, the default is 
/SHAREABLE. 
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If the device is set public, the default is /PUBLIC (synonym: 
/SYSTEM). 


See the discussion of public, private, and shareable volumes in 
Section 5.1.3. 


/ [NO] SHOW 


Specifies that information about the volume being mounted is to 
be displayed on your terminal. 


Here is the display format for disks and other random-addressable 
devices: 


Volume Information 

Class: Files-11 or Foreign 

Device: ddnn: 

Volume label: label 

Pack Serial: serial number supplied by manufacturer 


Owner: [g,m] 
Protection: code 
Default: code 
Processor: acpname 


The owner field indicates the owner of the volume. The UIC must 
be matched for protection checks for owner privileges. The owner 
UIC can be changed with the /OWNER qualifier. See Sections 5.1.3 
and 4.1.5 for more information. Protection indicates volume 
protection: Default indicates file protection. 


The information displayed by /SHOW is similar for magtapes. If 
multiple tape volumes are being mounted, the device and volume 
label information is repeated for each volume. The Protection 
and Default fields are omitted from the volume information for 
magtapes. 


/{NO]WAIT 


Specifies whether you require operator assistance in performing 
the mount. The main use of this qualifier is for batch jobs, 
indirect command files, or terminals distant from the machine 
room. The default is /WAIT for mounts in batch jobs and indirect 
command files, and /NOWAIT for interactive mounts. 


If the mount is included in a batch job or indirect command file, 
or if you specify /WAIT in an interactive mount, a message 
concerning the mount is sent to the operator's console and the 
mount is not completed until the operator physically places the 
disk on the drive and spins it up. If you specify /NOWAIT in a 
batch job or indirect command file, or if the mount is 
interactive, no message appears. The medium must have been 
placed on the device and readied for access (spun up/on-line). 
See the examples. 


‘Batch processing te, ‘available on RSX-11M-PLUS systems. only. ~- Por 
‘more information on mounts from batch jobs, see the discussion of 
MOUNT in the RSX-11M/M-PLUS Batch and and | ‘Queue © erations ‘Manual. — : 
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/(NOJWRITE 


Specifies whether the volume is to be write-protected. The 
default is /WRITE. If /WRITE is specified or implied, the volume 
can be written to as permitted by the volume-protection and 
file-protection codes established for the volume when mounted. 
See the discussion of volume protection and file protection in 
Section 4.1.5. If /NOWRITE is specified, no one may write to the 
volume. 


Command Qualifiers for Files-1ll Devices 
/ACCESSED:n 


Specifies the approximate number of directories that will be 
accessed simultaneously during the mount. Legal values for n 
range from 1 through 127. FIIACP maintains a list of most 
recently used directories. The value specified for /ACCESSED 
sets the number of entries in this list. 


In general, directory operations can be significantly speeded up 
by increasing this value. If a directory appears in the list, no 
disk I/O is required to find the directory in the MED. In 
addition, directory operations take place without the necessity 
of reading the directory file header. If this qualifier is not 
explicitly stated, the default is the value specified at the time 
the volume was initialized. Note that increasing the /ACCESSED 
value increases the amount of system pool used. 


/EXTENSION:n 


Specifies the number of blocks by which a file will be extended 
if it exhausts its space allocation. The value of n can be from 
1 through 127. The default is the value specified when the 
volume was initialized. 


/OWNER: [g,m] 


Specifies the owner of the volume. The brackets are required 
syntax. This qualifier overrides the OWNER value established 
when the volume was initialized. The owner value is used with 
file and volume protection. See Section 4.1.5. 


/UNLOCK 


Specifies that the volume index file, [0,0] INDEXF.SYS, is 
unlocked. ‘This means the file can be read and written to. 
Normally, this file is locked and can be read only. 


This qualifier has nothing to do with hardware or software 
write-locking. 
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/WINDOW: arg 
n 
(USER:n, INDEX:n) 


Specifies the default number of mapping pointers to be allocated 
for file windows when the file is accessed. Legal values for n 
range from 1 through 127 or the word FULL. A file window 
consists of a number of mapping pointers stored in memory when 
the file is opened. If you specify FULL, windows are created 
that map as much of the file as possible. 


If you wish, you can specify different values for the user 
default and index file. If separate values are specified, the 
volume default will be the same as the user default specified and 
the index file window is created with the value specified. 


The default for /WINDOWS is the value specified in the Volume 
Home Block. This value is established when the volume is 
initialized. If you wish to change that value, see the 
INITIALIZE/UPDATE command (Section 5.8.1) for information on 
altering the Volume Home Block. 


Command Qualifiers for ANSI and Unlabeled Tapes 
/BLOCK_SIZE:n 


Specifies the block size in characters for unlabeled magnetic 
tapes at the time of the mount. Values for n can be from 18 
through 16000. This qualifier also works on ANSI Level 1 or 2 
magnetic tapes, that is, those without HDR2 records (labels). 


/CARRIAGE CONTROL:arg 
FORTRAN 
LIST 
NONE 


Specifies the record type for an unlabeled tape. The arguments 
correspond to the FORTRAN keywords for the OPEN statement. This 
qualifier also works on ANSI Level 1 or 2 magnetic tapes, that 
is, those without HDR2 records (labels). This qualifier also 
works for ANSI Level 3 magnetic tapes that do not have a= system 
code (HDR1 CP 61) beginning in DEC or OS. 


/DENSITY:arg 
800 
1600 
6250 


Specifies the density at which data is to be written to the tape. 
The default is the lowest density supported by the specified tape 
unit. If the specified tape unit does not support the density 
given, the command is rejected. 


/ {NO]HDR3 


Specifies whether an HDR3 label is to be written when creating 
new files. The /NOHDR3 qualifier is needed only in the situation 
where it is known that the target system cannot handle aé_e tape 
with a HDR3 label. This qualifier has no other effect or 
application. The default is /HDR3. 
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[NO] LABEL 


Specifies whether the tape volume is ANSI or unlabeled. An _ ANSI 
tape is specified by the /LABEL qualifier. This is the default. 
An unlabeled tape is specified by the /NOLABEL qualifier. 


/OVERRIDE: (arg[,s]) 


ACCESSIBILITY 
EXPIRATION DATE 
IDENTIFICATION 

SET IDENTIFICATION 


This is a privileged qualifier. 


Specifies that you wish to override one or more characteristics 
of a tape volume that are normally checked when you mount a 
magnetic tape. The parentheses are optional if you wish to 
specity only one argument. If you wish to specify more than one 
argument, the arguments must be enclosed in parentheses” and 
separated by commas. 


The ACCESSIBILITY argument specifies that you wish to override 
the protection on ANSI magnetic tapes. 


The EXPIRATION DATE argument specifies that you wish to override 


the expiration date on ANSI magnetic tapes. 


The IDENTIFICATION argument specifies that you wish to mount’ the 
tape or tape set without specifying a File Set ID. By default, 
the File Set ID is the Volume ID of the first tape reel in the 
set. See Section 5.6.1. 


The SET IDENTIFICATION argument specifies that you wish to mount 
a tape or tape set that does not follow ANSI standard. This 
argument is not otherwise needed. 


f 


/RECORD SIZE:n 


Specifies the record size in characters for unlabeled magnetic 
tapes. The value for n can be from 1 through the value for 
blocksize on the volume. 


/TRANSLATE:arg 


EBCDIC 
NONE 
UT1 
UT2 
UT3 


Specifies the character translation to take place for reading 
from and writing to the mounted unlabeled tape volume. NONE 
specifies no translation and is the default. EBCDIC specifies 
translation from ASCII to EBCDIC for writes and from EBCDIC to 
ASCII for reads. Note that the translation is not one-to-one 
because some characters are found only in EBCDIC or only in 
ASCII. UT1l, UT2, or UT3 specify user-supplied translation tables 
that have been previously linked into the MTAACP. See the 
RSX-11M/M-PLUS I/O Operations Manual for further information. on 
character translation. 
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/VOLUME IDENTIFICATION: (volumeID[,volumeID[,s]]) 


Specifies Volume Identifiers. If you wish to check Volume _ IDs, 
you must specify this qualifier. If the File Set ID is not the 
same as the Volume ID of the first tape in the set, you must use 
this qualifier and include all Volume IDs in the set. See 
Section 5.6.1 for more information and for examples of this 
qualifier in use. 


Examples 
>MOUNT 
Tevice? DRI¢ 
Volume Inf KOTRONM 


This example mounts the volume labeled HOTROD on device DKl:. If 
you are doing nothing more than mounting a volume to read from it 
or write to it, you will probably not need a more complicated 
MOUNT command than this. 


All default values for the mount come from the Volume Home Block. 
This block is written when the volume is created by INITIALIZE or 
by some other system task, such as a backup utility, that creates 
a file structure on the volume. Most of the qualifiers to MOUNT 
are used to override values in the Volume Home Block. 


SMOUNT/TENSTTY(1460 CHMO? «MAL shih 2d) “WAMBAT" «© OOBAR FOO 


Specifies that a three-volume ANSI magnetic tape set be mounted 
on devices MMO:, MMl1:, and MM2:. The volume labels are W*MB*T, 
FOOBAR, and FOO. The first label is included in quotes to allow 
specification of the asterisk (*). Note that the comma between 
"W*MB*T" and FOOBAR is outside the quotation marks. 


“=MOUNT/FROCESSOR {AR XACE SFOREIGN/FARAMETERS 3 "KUMBLFRAZ * 
Yevice? DRO: 
Volume iLlsbeli? AARFO 


This example mounts the volume labeled HARPO on device DRO:. The 
volume's file structure is controlled by a non-DIGITAL ACP named 
MRXACP, so the ACP must be named and the volume mounted foreign. 
This ACP accepts special commands. These are entered using the 
/PARAMETERS qualifier with the command string in quotation marks. 


»MOUNT/SNOLABEL/BLOCK (2048 /RE CORDS G4/CARRIFORTRAN/TRANSLIERCITS MM4 ¢ 


The example mounts an unlabeled magnetic tape on device MMl1:, 
specifying a block size of 2048 characters and a record size of 
64 characters. The volume includes FORTRAN carriage control, so 
that is specified. The volume's records are written in EBCDIC 
characters, so the user included the /TRANSLATE qualifier. The 
characters will be translated to ASCII for handling by the 


operating system and translated back to EBCDIC for writing to the 
tape volume. 
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The user wishes an operator to place the medium containing the 
proper volume in place on DBl:. The command may appear ina 
batch job, indirect command file, or interactive mount, perhaps 
from a user on a remote terminal. The following message appears 
on CO:, the operator's console: 


cai Flesse mount volume WHIZZER on DEL: 
Tyre 

UNS (DCL START) when read 

or 


RES (DCL CONTINUE) to revect reauest. 


The operator performs the requested operation and the mount takes 
place, if the device was available and the operator typed START 
(MCR UNS). If the device was not available and the operator 
typed CONTINUE (MCR RES), the mount fails. ‘The batch processor 
attempts to continue the job. The same is true if the command 
appeared in an indirect command file. 


1M-PLUS ‘only. 


Notes 


You should not confuse mounting with physically placing the disk 
or other magnetic medium on a drive. Naturally, you must place 
the medium on a drive and spin it up (for a disk) or load it (for 
a tape) before you can do anything else with it, but mounting is 
enabling the system software to access the medium, either to read 
or write data, or to establish a file structure for the volume. 


If you attempt to mount a volume on a device where the disk is 
not properly spun up, MOUNT will wait 30 seconds and try the 
mount again. If the disk is not spun up after 30 seconds, the 
mount fails. This feature has nothing to do with the /WAIT 
qualifier. 


There are four states of device ownership: 


Private The device has been made private through the 
ALLOCATE command or the /NOSHAREABLE qualifier to 
MOUNT. Only you can access the volume. 


Shareable The device has been mounted /SHAREABLE. Any user 
can mount the volume. 


Public The device has been made public through the SET 
DEVICE/PUBLIC command or the /PUBLIC (or /SYSTEM) 
qualifier to MOUNT. Only a privileged user can 
set a device public. 


Unowned No one has mounted a volume on the device, nor is 
it allocated or set public. 


See the discussion of public, private, unowned, and shareable 
devices and mounted volumes in Section 5.1.3. 


You cannot put comments in a MOUNT command line, 
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DISMOUNT counteracts MOUNT. See Section 5.7 for a description of 
DISMOUNT with examples. 


Some file attributes and positioning information for magnetic 
tape volumes or tape sets can be supplied after mounting using 
the MAG utility. For more information, see the RSX-11M/M-PLUS 
I/O Drivers Reference Manual. 


See the introduction to this chapter for more information on how 
the operating system deals with devices and volumes. See also 
the description of the INITIALIZE command in Section 5.8. 


5.6.1 Mounting Magnetic Tapes and Tape Sets 


Mounting of magnetic tape volumes is handled by a special ACP, the 
MTAACP, This ACP handles not only magnetic tapes that meet the ANSI 
standard but also the most commonly encountered unlabeled tape 
formats. 


The MOUNT command can only mount a single random-addressable volume, 
but magnetic tapes can be mounted by the set. In fact, when you mount 
a single magnetic tape, you are mounting a set consisting of only one 
tape. A magnetic tape set consists of logically related records 
written on one or more individual reels of tape. Only the first tape 
in the set need be loaded on a device at the time the MOUNT command is 
issued. However, all tapes in the set can be loaded on different 
devices at the time the MOUNT command is issued. 


Therefore, the terminology used for mounting magnetic tapes is 
somewhat different from that used in mounting disks. The tape set is 
identified by a File Set Identifier (File Set ID). Each individual 
tape in the file set is identified by a Volume Identifier (Volume ID). 
By default, the File Set ID is the same as the Volume ID of the first 
individual reel of tape in the set. 


If you wish to use a File Set ID other than the Volume ID of the first 
reel in the set, you can do so on the first mount of a newly 
initialized tape as shown in the examples. 


Each installation using magnetic tapes extensively will have policies 
on File Set IDs and Volume IDs. See your system manager or Supervisor 
for information on how they are used in your installation. 


The following examples establish the relationship between File Set IDs 
and Volume IDs. 


The following command 
“MOUNT MMGs FOO 
mounts a tape set (consisting of a single physical reel) whose File 


Set ID is FOO and whose Volume ID is FOO. The reel FOO must be loaded 
on device MMO: at the time of the mount. 
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>MOUNT MMO? DDRAG/VOLUME_IDENTIFICATION: (FOO, RAR» MORE 3} 


mounts a tape set whose File Set ID is DRAG and that consists of three 
physical reels with Volume IDs of FOO, BAR, and MORE. The reel with 
the Volume ID FOO must be loaded on device MMO:, but the other’ two 
reels are not loaded at the time of the mount. The File Set ID of the 
tape set was established with the first mount of the newly initialized 
tape set, using this same command. If this were the first mount, the 
File Set ID DRAG would be established by the MOUNT command, but’ the 
actuai change of the File Set ID (from the default of FOO) does not 
take place until the first record is written to the tape. 


The command 
sMOUNT/OVERRIDE:SET_ IDENTIFICATION NMG: ‘FOG» BAR y MORE * 


mounts a tape set whose File Set ID is immaterial and that consists of 
three physical reels with Volume IDs of FOO, BAR, and MORE. The reel 
FOO must be loaded on device MMO:, but the other two reels are not 
loaded at the time of the mount. 


The following command 
“MOUNT MMOS FOO /YVOLUMELIDY (AS1L2+A387:B251: 


mounts a tape set whose File Set ID is FOO and that consists of three 
physical reels with Volume IDs A312, A387, and B231. The reel A312 
must be loaded on device MMO0:, but the other two reels are not loaded 
at the time of the mount. 


The following command 
=MOUNT (MMOS sMMLteMMSt: CFOOs ARs MORE? 


mounts a tape set whose File Set ID is FOO and that consists of three 
physical reels with Volume IDs FOO, BAR, and MORE. At the time of the 
mount, the reel FOO must be loaded on device MM0O:, the reel BAR must 
be loaded on device MMl:, and the reel MORE must be loaded on device 
MM2:. 


NOTE 


There is no theoretical limit to the 
number of physical tape reels in a set, 
but your DCL MOUNT command must 
translate to an MCR MOU command of 80 
characters or fewer. There are, 
therefore, mounts that are permitted by 
the system but that cannot be translated 
successfully from DCL to MCR within that 
limit. In those cases, you cannot’ use 
the DCL MOUNT command but must use the 
MCR MOU command. Remember, you can use 
the MCR command to enter MCR commands 
from a DCL terminal. 
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Error Messages 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


-- ACP not in system 


Explanation: The task specified as the ACP, or the default ACP, 
is not installed in the system. 

User Action: See your system manager. 

-- Device not in system -ddnn: 

Explanation: The command specified a device not present in the 
system. 

User Action: Retype command after checking device list (SHOW 
DEVICES) or see your system manager. 
-- Device specified twice 

Explanation: The command specified the same device twice. 

User Action: Retype command after checking proper syntax. 
-- Driver not loaded 

Explanation: The command named a device whose driver is not 
loaded. 

User Action: See your system manager. 

-~ Failed to attach device -ddnn: 

Explanation: The command named a device that was attached by 
another task and could not be mounted. 

User Action: Check device list (SHOW DEVICES) and find out if 
the device is in use. See your system manager. 
-- Home block I/O error 

Explanation: An I/O error was detected in trying to read the 


Volume 


Home Block. 


This message often indicates that the device 


is not ready, or that the disk has not been initialized. 


User Action: Wait until the disk is spinning at full speed and 
try again. 
-- Illegal keyword combination 

Explanation: The command specified conflicting qualifiers. 

User Action: Retype command after checking proper syntax. 
-- Index file I/O error 

Explanation: MOUNT could not read either the index file header 


or the storage allocation file. 


User Action: 


See your system manager. 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 


MOU 
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-~- No such device available 


Explanation: The command named a device not present in the 
system. 


User Action: Retype command after checking device list (SHOW 
DEVICES) or see your system manager. 


-- Not file-structured device 


Explanation: The command named a device that is not supported as 
a Files-1l device, including ANSI magnetic tape. 


User Action: Retype command after checking for proper device 
name. 


-- Parameter conflicts with mounted volume 
Explanation: An attempt was made to mount a previously mounted 
volume uSing qualifiers that conflict with those specified when 


the volume was originally mounted. 


User Actions Check with SHOW DEVICE and confirm qualifiers with 
other user. See your system manager. 


-- Storage bit map file I/O error 


Explanation: An I/O error was encountered while reading the 
storage allocation file. 


User Action: Check to be sure you have the correct magnetic 
medium, or the volume has not been initialized. See your system 
manager. 


-- Task not ACP 


Explanation: The task named with the /ACP qualifier does not 
have the characteristics of an ACP. 


User Actions Check to be sure you have named the right task. 
~- Undefined density selection 

Explanation: The command specified an illegal density value. 
User Action: Retype command after checking proper syntax. 

-- Unit allocated to or in use by another user 


Explanation: The command specified a device that is already in 
use, 


User Action: Check on the status of the device with SHOW DEVICES 
and take the appropriate action. 
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Explanation: The command included a /DENSITY qualifier but named 
a device that does not accept it. 


User action: Retype command after checking proper syntax. 
MOU -- Unit does not support 800 BPI 


Explanation: The command specified a device that does not 
support the 800 BPI density. 


User Action: Retype command after checking proper syntax. 
MOU -- Unit does not support 1600 BPI 


Explanation: The command specified a device that does not 
support the 1600 BPI density. 


User Action: Retype command after checking proper syntax. 
MOU -- Unsupported file header format 


Explanation: The Volume Home Block does not conform to Files-1l 
format. Volume may be corrupted. 


User Action: Volume could be mounted with the / FOREIGN 
qualifier, or see your system manager. 


MOU -- Volume already mounted -ddnn: 


Explanation: An attempt was made to mount a volume on ae device 


that already had a mounted volume. In multiuser protection 
systems, only random-access devices can be mounted by multiple 
users. 


User Action: See your system manager. 
MOU -- Wrong volume label 


Explanation: The volume label on the label and the volume label 
in the command do not match. 


User Action: Retype command after checking for proper volume 
label. Privileged users can use the /OVERRIDE: IDENTIFICATION 
qualifier. 


5.7 DISMOUNT 


DISMOUNT marks the volume mounted on the specified device to be 
logically off line and disconnected from the file system. Marking a 
volume for dismount prevents programs from opening new files on the 
volume. After all open files on the volume have been closed, the ACP 
dismounts the voiume. 
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Format 


DISMOUNT [/qualifier[s] ] 
Device? ddnn: [volumelabel] 


DISMOUNT [/qualifier[s]] ddnn: [volumelabel] 
Command Qualifiers 


/ALL 
/PUBLIC 
‘-/ SAVE. 
/SYSTEM Shai for /PUBLIC) 


Specifies the device on which the volume is mounted. 


volumelabel 


Specifies the volume label or File Set ID for magnetic tape. 
This parameter is optional, but if it is specified, the label or 
File Set ID is checked against the mounted volume. The volume 
label or File Set ID can be a quoted string, following the same 
rules as explained in the discussion of MOUNT, Section 5.6.1. 
There is no prompt for this parameter. 


Command Qualifiers 


/ALL 
Specifies that all volumes mounted from the terminal at which the 
commmand is issued be dismounted. A message informs you of each 
dismount as it takes place. No device name or volume label is 
accepted with this qualifier. See the example. 

/PUBLIC 

/SYSTEM 
Causes all users to be dismounted from a _ volume. This is a 
privileged qualifier. A DISMOUNT/PUBLIC frees the device, no 
matter who has mounted the volume on it. This is the only way to 
dismount a public volume. /SYSTEM is a synonym for /PUBLIC, 
included for compatibility with VAX/VMS. 


‘7SAVE | 


Se qualifier. is. ‘for. ‘RSX-11IM-PLUS- systens. only. It applies to 
- DB Sy DM: , and DUE. devices OLY ' ee 


“Specifies” that eg disk is to remain. “spinning. in. “the “drive “and 
“ean be accessed for read or write py Oct vitesse tasks. This © ‘is a 


privileged qualifier, 
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the most common use “of /SAVE is when. saving OE “backing up. the 
“system “disk. Ifyou. ‘Simply wish to leave. the atek ‘spinning, use 
Ooo CHS: /NOUNLOAD qualifier. ‘Remember , ' these values can also. beset 

<M the ‘/DEFAULT Seer ee to. MOUNT: “See Section “Sy 6. <0 Os 


(/TERMINAL: pea 


This qualifier is for RSX-11M- PLUS only. 


Ri tows: a privileged user. chee ‘dismount. ‘a volume mounted “from: 
“another: terminal. a Erinn tierce Wen, RUA 


/{NOJONLOAD : eae 3 
The /ONLOAD and /NOUNLOAD Pe are for RSX—-11M-PLUS systems 


only. PEK apply. ‘toy DB DME 7 20g. DU: disks’ and: magnetic tapes: 
onkys : bate ace a ie 


The “ONLOAD. qualifier specifies, that fon is. to. Spin down 
“after the dismount. Th 

For. magnetic. tapes, . 
completely rewound. 


the tape” ‘to be 


(for 
example, the. RC25). only if. ‘you care. ‘a! priviteged user. If you are 
a nonprivileged user and you ey to _Gismpunt the unit or dagen! 
ZONLOAP: in the command 1 


The /ovnizono qualatier. specities that the disk is to remain 
"the: dismount. This is the default for foreign 
_ The: / NOUNLOAD qualifier is useful when . the 
" remounted. For magnetic tapes, this 
ao first: file position. 


- /[NO]UNLOAD and the 
“these values’ can also. be set 
See. Section 5.6. 


Examples 
*TISMOUNT 
Device? DRO? 
DIS -- TTi1i: DTismounted from DKF MEX Wirel Tlasmount [rmitiebad ##* 


This example dismounts a volume on device DKO:. No other user 
had the volume mounted when the DISMOUNT command was issued. 


“DISMOUNT DOKL? wHOTROD 

VIS -- TTSé6: Dismounted from DOKRO? 
This example dismounts a volume on device DKl:. The user 
specified the label HOTROD to be sure the correct volume was 
mounted on the device. The volume was mounted shareable and some 


other user also has it mounted, so the informational message does 
not include the notification of final dismount. 
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veHO TT1il: Tismounted 
Heve se sood morninms 

ee -NOGV-B82 TTili Los¢eqd 


-- Prom 


aff 


This example dismounts a volume a 
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HEE Farna!l dismount ### 


s part of the LOGOUT procedure. 


The user had the volume mounted on the device and had not 
dismounted it before logging off. LOGOUT dismounted the volume. 
If the device was allocated, LOGOUT also deallocated it. This is 
the equivalent of DISMOUNT/ALL. 
The informational message is headed by DMO rather than DIS 
because, at this point, DCL is no longer involved in the 
dismount. 

>DISMOUNT/ALL 

RES -- TT11? Tismounted from DEG? 

“IS TT11: Tismounted from DK1? KEE Fainel diecmournl *#X# 
GIS —-- TTiL: Tiswaunted from MM2t KAK Fine] diecmuount #KX 
This example dismounts all volumes mounted from the terminal at 

which the DISMOUNT was issued. See next example. 
SDISMOUNT/ALL 
NES TT1il: Tismounted from URG? 
Pies Ss: Pres Hismounted from Ti? KEK Fingl sismount X¥*% 
gis --— TTii: iiemounted from MH23 KAK Fine. dismount €*xX 
“MOUNT [X13 CRUCIAL. 

This example dismounts all volumes mounted from the terminal at 


which the DISMOUNT was issued. 
a volume was mounted on DXl:. As 
running task, the user immedi 
using the volume label CRUCIAL. 
attempt to open a file and did 
the time of the message and the 
DISMOUNT has no effect on the ta 
open remain open. 


Tr 


=DISMOUNTSPUBLIC [B35 

QiIsS -- TTeit Nismounted fram 
VIS -- T273 Discmounted from 
TIS -~-~ TT3i;: Uiemounted fram 
Yiooe= Tisa. QUiemounted from 


In this example, a privileged use 
mounted the volume on DB3:. 


Notes 
DISMOUNT counteracts MOUNT. 


LOGOUT issues 
dismounts 


a DISMOUNT/ALL 
all volumes mounted fr 


explicitly through a MOUNT command or implicitly through 


that spawns a MOUNT command. 


he message reminds the user that 
this volume was necessary to a 
ately issued a new MOUNT command 
So long as the task did not 
not close its last file between 
time of the new MOUNT, the 
sk. All files that the task had 


TES? 
Wes: 
OBS; 
Tes 3 KKK Final dismount KR 
r dismounted all users who had 
automatically. DISMOUNT/ALL 
om the terminal, whether mounted 
a task 
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You cannot include comments in a DISMOUNT command line. 


The messages from the ACP to your terminal indicate only that the 


volume 


is marked for dismount. The actual completion of the 


dismount is noted on the operator's console. 


CAUTION 


When the dismount operation is complete, the ACP prints 
the following message on the operator's console (CO:): 


*** ddnn Dismount complete 


This message does not appear until all files open on the 
volume are closed. Do not remove the medium from the 
drive until this message appears on CO:. If you remove 
the medium before the message appears, the present volume 
may be corrupted and the next volume mounted on that 
device will be corrupted. 


Error Messages 


DIS -- Warning -- All units of multiunit drive will spin down <ddnn:> 


Explanation: When a unit of a multiunit device is spun down (by 
a privileged user), all other units of the device are also spun 


down. 


This warning message appears on RSX-11M-PLUS systems only. 


DIS -- Warning -- Volume will not spin down <ddnn:> 


Explanation: An attempt was made by a nonprivileged user to spin 


down 


the removable unit of a multiunit device, either implicitly 


with the DISMOUNT command or explicitly by specifying /UNLOAD in 
the command line. Only privileged users can spin down multiunit 
devices. (For nonprivileged users, the volume is. logically 
dismounted but not spun down.) This warning message appears on 
RSX-1LIM-PLUS systems only. 


DIS -- Checkpoint file still active 


Explanation: The command attempted to dismount a volume that 
contained an active checkpoint file. The volume cannot be 
dismounted until the checkpoint file has been closed. 


User 


Action: Wait, Or, if privileged, issue a SET 


DEVICE:ddnn:/NOCHECKPOINT and reissue the DISMOUNT after 
receiving the system message indicating that the checkpoint file 
is no longer active. 


DIS -- Volume not mounted 


Explanation: The command specified a device that was not 
mounted. 


User Action: Retype command after checking SHOW DEVICES for 
mounted devices. 


HANDLING DEVICES AND VOLUMES 


INITIALIZE 


DIS -- Volume not mounted by TI: 


Explanation: The command attempted to dismount a volume mounted 
from another terminal. 


User Action: Dismount the volume from the proper terminal, or 
have a privileged user dismount the volume. 


DIS -- Wrong volume label 
Explanation: The command included an incorrect volume label. 


User Action: Reissue the command without specifying a volume 
label or check the volume label to be sure you are dismounting 
the right volume. 


5.8 INITIALIZE 
INITIALIZE produces a volume in Files-1l format. 


For disks and DECtapes, INITIALIZE destroys all existing files, writes 
a dummy bootstrap and a Volume Home Block, and builds the directory 
structure. 


For magnetic tapes, INITIALIZE writes an ANSI standard volume label 
and a dummy file that destroys all existing files. 


Many of the values specified in the INITIALIZE command can be changed 
with the INITIALIZE/UPDATE command without disturbing existing data on 
the volume. See Section 5.8.1. 


Format 


INITIALIZE[/qualifier[s]] 
Device? ddnn: 
Label? volumelabel 


INITIALIZE[/qualifier[s]] ddnn: volumelabel (volume-ID) 
Command Qualifiers 


/ACCESSED:n 
/DENSITY:arg 
800 
1600 
6250 
/EXTENSION:n 
/HEADERS:n 
/INDEX:arg 
BEGINNING 
MIDDLE 
END 
n 


HANDLING DEVICES AND VOLUMES 


INITIALIZE (Cont.) 


/MAXIMUM_ FILES:n 
/OWNER: [g,m] 

/FILE PROTECTION: (code) 
/PROTECTION: (code) 


/ [NO] SHOW 
/BAD_BLOCKS:arg 
AUTOMATIC 
MANUAL 
OVERRIDE 
/WINDOWS :n 
Parameters 
ddnn: 


Specifies the name of the device on which the magnetic medium to 
contain the volume has been placed. 


volumelabel 


Specifies the label the volume is to be initialized with. The 
label names the volume and must be specified by nonprivileged 
users when they mount the volume. The volume label is in effect 
a password controlling access to the volume. For magnetic tapes, 
the situation is more complex. See Section 5.6.1. 


For disks and DECtapes, volumelabel can be as many as 12 
characters. 


For magnetic tapes, Volume ID can be as many as six characters. 
See Section 5.6, the MOUNT command description, for details on 


the characters that can be included in volume labels and Volume 
IDs. 


Command Qualifiers 


Selecting command qualifiers for INITIALIZE requires a_ good 
knowledge of the Files-ll file structure. You should see the 
IAS/RSX-11l 1/0 Operations Reference Manual for further 
information. 


Defaults to INITIALIZE enable you to initialize a volume in a 
standard fashion, but the qualifiers allow much more flexibility 
in using the system. 


/ACCESSED:n 


This qualifier specifies the number of directories that will be 
accessed simultaneously. FLIACP maintains a list of most 
recently used directories. If a directory is in this list, no 
disk I/0 is required to find the directory in the Master File 
Directory, nor do directory operations require that the directory 
file header be read. In general, directory operations can be 
speeded up significantly by increasing the /ACCESSED count but at 
the potential cost of pool. 


The default n is 3. Legal values for n range from 1 through 127. 
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/DENSITY:arg 
800 
1600 
6250 
HIGH 
LOW 


Specifies the density in bits per inch (bpi) for the medium 
loaded on the device. The argument can be 800, 1600, 6250, HIGH, 
or LOW, depending on the device type. Only volumes on media for 
certain devices can be initialized at different densities. You 
must mount the volume at the same density with which it was 
initialized. 


This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 


Here are the acceptable density values for DIGITAL devices with 
Switchable density: 


Mnemonic Device Densities 

MF: (magnetic tape) TU78 1600 
6250 (default) 

MM: (magnetic tape) TE16 800 (default) 
1600 

MM: (magnetic tape) TU1LE 800 (default) 
1600 

MM: (magnetic tape) TU45 800 (default) 
1600 

MM: (magnetic tape) TU77 800 (default) 
1600 

MS: (magnetic tape) TS11 1600 

DY: (floppy) RX02 LOW (or single) 


HIGH (or double) (default) 
/EXTENSION:n 


Specifies the number of blocks by which the file is to be 
extended when its allotted space is exhausted. Default n is 5. 


This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 


/ HEADERS in 


Specifies the number of file headers to be allocated initially in 
the index file. The five system files INDEXF.SYS, BITMAP.SYS, 
CORIMG.SYS, BADBLK.SYS, and 000000.DIR are not included in the 
value for n. 
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The default value of n is proportional to th 
medium; the minimum allocation is 16 headers. 


Mnemonic 


/MAXIMUM_FILES:n 


Device 


DECtape II 
RF1l 
RKO5 
RKO6 
RKO7 
RLO1 
RLO2 
RPO2 
RPO3 
RP04/05 
RP06 
RM02/03 
RMO5 
RPO7 
RS03/04 
DECtape 
RA60 
RA80 
RA81 
RC25/RCF25 
RD51 
RM80 
RX50 
RXOL1 
RX02 
ML11 


e capacity 


File Headers 
Allocated Initially (n) 


16 

16 
147 
834 
1654 
314 
629 
1230 
2460 
5283 
10478 
4049 
25593 
51699 
16 

16 
12308 
7314 
51699 
3020 
602 
7461 
16 

16 

16 
Varie 


s 


of 


Specifies the maximum number of files permitted on the volume. 


The value of n includes the five system files. The value 
must be less than or equal to the maximum value of n given in the 
table. The following table also includes the default vaiues of n 


for each device. 


Mnemonic 


Device Default n 
DECtape II 30 
RF11 62 
RKO5 294 
RK06 1668 
RKO7 3308 
RLOL 629 
RLO2 1259 
RPO02 2460 
RP03 4920 
RP04/05 10567 
RPO6 20956 
RM02/03 8099 
RM02/03 8099 
RMO5 30781 
RPO7 62007 


Maximum n 


247 
499 
2357 
13344 
25600 
5034 
10074 
19680 
25600 
25600 
25600 
25600 
64798 
65500 
65500 


of 


the 


n 
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DS: RSO03 62 499 
DS: RSO04 125 1003 
DT: DECtape 34 278 
DU: RA60 24617 65500 
DU: RA80 14629 65500 
DU: RA81 54815 65500 
DU: RC25/RCF25 6040 48326 
DU: RD51 1204 9633 
DU: RM80 14923 65500 
DU: RX50 48 388 
DX: RxXO1 29 238 
DY: RxX02 60 481 
EM: ML11 Varies Varies 
This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 
/INDEX:arg 
BEGINNING 
MIDDLE 
END 
n 
Specifies the location of the index file on the volume. This 
qualifier forces a specified location for the index file, the 
Master File Directory, and the storage allocation file. This is 
usually done to minimize access time. 
Four possibilities are available for the argument field: 
BEGINNING The beginning of the volume. This is the default 
for tapes and DECtapes. 
MIDDLE The middle of the volume. This is the default for 
most disks. 
END The end of the volume. 
n Logical block n. 
/FILE_ PROTECTION: (code) 
Specifies the default protection for all files on the volume 
being initialized. See Section 4.1.5 for more information on 


file protection codes. 
Default protection code: 


(SYSTEM: RWED, OWNER: RWED, GROUP: RWED , WORLD: R) 


This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 

/OWNER: [g,m] 
The /OWNER qualifier specifies the owner of the volume. Group 


and member 
is [1,1]. 

protection. 
file protection. 


numbers range from 1 through 377. 


The default owner 
The /OWNER value is used for checking volume and 
See Section 4.1.5 for more information on volume and 


file 
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/PROTECTION: (code) 


The /PROTECTION qualifier specifies the default protection for 
new files created on the volume. See the discussion of volume 
protection in Section 4.1.5. The code for volume protection is 
similar to that for file protection, except that the "E" for 
EXTEND protection is replaced by a "C" for CREATE protection. 


/ {NO] SHOW 
The /SHOW qualifier specifies that you wish to see all the values 
with which the volume is being initialized. /NOSHOW is the 
default. 
These values are identified in MCR terms. Here are the DCL 


equivalents: 


Display DCL Equivalent 
Label Label 
/Bad /BAD BLOCKS 
/Cha Not used by RSX-11M/M-PLUS 
/EXt. / EXTENSION 
/FProO. /FILE PROTECTION 
/Indx. / INDEX 
Jinks / HEADERS 
7GEUs / ACCESSED 
{UKE /MAXIMUM_ FILES 
/Pro. /PROTECTION 
/Uic. /OWNER 
/Win /WINDOWS 
/BAD_BLOCKS:arg 
AUTOMATIC 
MANUAL 
OVERRIDE 


/BAD_BLOCKS:AUTOMATIC specifies that bad-block information for 
the volume is to be determined automatically from a file named 
BADBLK.SYS created by the BAD utility. This is the default. 


/BAD BLOCKS:MANUAL specifies that bad-block information for the 
volume is to be entered manually. 


/BAD_BLOCKS:OVERRIDE specifies that bad-block information is to 
be ignored. 


See Chapter 6 of the RSX-11M/M-PLUS Utilities Manual for more 
information on BAD. 


/WINDOWS :n 


Specifies the number of mapping pointers to be allocated for file 
windows. A file window consists of a number of mapping pointers 
stored in memory when the file is opened. Default n is 7. 


This value can be altered on an existing volume with the 
INITIALIZE/UPDATE command. See Section 5.8.1. 
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Exampies 


>INIIALIZE 
Tevice? DKO} 
Volume ID?  HONGLULU 


This example initializes a volume with the volume label HONOLULU 
on device DKO:. See next example. 


PALLOCATE DKO} 
*MOUNT/FOREIGN DRO: 
*INITIALIZE DRO? HONOLULL 
*DISMOUNT DRO? 

*MOUNT DROS HONOLULU 


This example illustrates the process necessary to turn a fresh 
disk into a volume in Files-ll format that you can use. (This 
example assumes bad block information from BAD has already been 
written on the medium.) See Section 5.1.4 for a more detailed 
treatment of this process. 


First the device is allocated, or made private, so that no other 
user can access the device during this process. Then 
MOUNT/FOREIGN provides access to the disk although it is not yet 
in Files-1l format. The volume is initialized and given the name 
HONOLULU. The volume is then dismounted. Finally, the volume is 
mounted conventionally using the volume label HONOLULU. The 
/EOREIGN qualifier is not required on RSX-11M. 


SINIT/INGEXSEND/SPROTECTIONS (SYSTEMS RWED >» OWNER? » GROUP? 7 - 
~SWORLDG) DRL? MIFACLE 


This example initializes a volume named MIRACLE on a= medium 
mounted on device DKl:. The index file is placed at the end of 
the volume. Files on the volume are accessible to the system and 
privileged users only. The user used the continuation character 
(-) to make room for the command on a narrow terminal. 


Notes 


Nonprivileged users must allocate the device on which the volume 
is to be initialized. 


On RSX-11M systems, the medium need not be mounted to be 
initialized, but mounting with the /FOREIGN qualifier is 
recommended. pe a : 


On RSX-11M-PLUS, ‘you must’ use MOUNT/FOREIGN before INITIALIZE. 


See Section 5.6 for a discussion of MOUNT/FOREIGN as it applies 
differently to RSX-11M and RSX-11M-PLUS. 
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Error Messages 


INI 


INI 


INI 


INI 


INI 


INI 


INI 


-- Allocation for syst file exceeds volume limit 

Explanation: The system was unable to allocate a system file 
from the specified block because of intermediate bad blocks or 
end of volume. 


User Action: Enter command with different argument for the 
/INDEX: qualifier. 


-~ Bad block file corrupt - data ignored 
Explanation: Although the /BAD BLOCKS qualifier was selected, or 
defaulted to, the bad block data on the disk was not in the 


correct format and was therefore ignored. 


User Action: Process the medium with the BAD utility and 
initialize again. 


-- Block(s) exceed volume limit 


Explanation: The specified block or blocks exceeded the physical 
size of the volume. 


User Action: Retype command after checking for proper qualifier 
values. 


-- Boot block write error 


Explanation: An error was detected in writing out the volume 
boot block. 


User Action: Reenter the command. If it still does not work, 
see your system manager. 


-- Checkpoint file header I/O error 


Explanation: An error was detected in writing out the checkpoint 
file header. 


User Action: Reenter the command. If it still does not work, 
see your system manager. 


-- Command I/O error 


Explanation: INITIALIZE encountered an I/O error while reading 
the command line. 


User Action: Retype command line. If this fails, see your 
system manager. 


-- Data error 


Explanation: The command specified a bad block number or 
contiguous region that was too large. 


User Action: Retype command after checking proper syntax. 


ri 
Zs 
4 


INI 


INI 


INI 


INI 


INI 


INI 


INI 
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~- Device allocated to other user - ddnn: 


Explanation: Command specified a private device not allocated to 
your terminal. 


User Action: Retype command after checking SHOW DEVICES for 
proper device name. 


-~- Device not in system 


Explanation: Command specified a device not in the current 
system. 


User Action: Retype command after checking SHOW DEVICES for 
proper device name. 


-- Device not ready -ddnn: 

Explanation: The device was not up to speed (spun up). 
User Action: Wait and try again. 

-- Driver not loaded 


Explanation: Command specified a device for which the driver is 
not loaded. 


User Action: Retype command after checking SHOW DEVICES’ for 
proper device name. 


-- Failed to attach device -ddnn: 
Explanation: INITIALIZE failed to attach the specified device. 


User Action: Wait and try again. Check SHOW DEVICES. See your 
system manager. 


-- Magtape label must be specified 


Explanation: Command attempted to initialize a magnetic tape 
volume without specifying the required volume label. 


User Action: Retype command after checking proper syntax. 
Magnetic tape volume labels are limited to six characters. 


-- Magtape write error -ddnn: 


Explanation: While writing to the magnetic tape, the system 
encountered an I/O error. 


User Action: Retype command. 
-~- No bad block data found 


Explanation: Although the /BAD BLOCKS:AUTOMATIC qualifier was 
specified, or defaulted to, no bad-block data was found. 


User Action: Process the medium through BAD utility and try 
again. 
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INI 


INI 


INI 


INI 


INI 


INI 


INI 


-- Not file structured 


Explanation: The system does not support the 
Files-1l device. 


User Action: 


Public device -ddnn: 


Explanation: to 


public device. 


Command attempted 


User Actions 


initialize a 


device named as a 


Retype command after checking proper syntax. 


volume on a 


Nonprivileged users can only initialize volumes. on 
private devices. 
-- Undefined density selection 
Explanation: Command specified an illegal density argument for 
the device named. 
User Action: Retype command after checking for proper density 
argument. 
-- Unit is not at high density 
Explanation: Command specified that floppy disk in RX02 (DYnn:) 
drive be initialized at low density, but floppy was formatted at 


high density. 


User Action: Reformat floppy, or change it. 


-- Unit is not at low density 
Explanation: 


drive be initialized at 
formatted at low density. 


high density, 


User Action: Reformat floppy, or change it. 
-- Volume mounted Files-1ll 


Explanation: 
Files-ll. 


Command attempted to initialize 


User Action: Check to make sure you have the 
-- Volume mounted foreign with ACP 


Explanation: 
/FOREIGN but 


Command attempted to initialize 
with the /ACP qualifier. 


User Action: 
-- Volume name too long -- volumelabel 
included a 


Explanation: Command 


User Action: Retype command but limit volume 
DECtapes to 12 characters; magnetic tapes to 


Command specified that floppy disk 
but 


in RX02 (DYnn:) 
the floppy was 
a volume mounted 


right volume. 


a volume mounted 


Remount the volume without the /ACP qualifier. 


label for disks 
six characters. 
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5.8.1 INITIALIZE/UPDATE 


INITIALIZE creates a Volume Home Block that includes a number of 
values used by the ACP when you mount the volume. INITIALIZE/UPDATE 
uses the HOME utility to alter some of those values without affecting 
the other data on the volume. The INITIALIZE/UPDATE command is only 
for disk and DECtape volumes in Files-1ll format. 


Format 
/INITIALIZE/UPDATE [/qualifier[s]] ddnn: volumelabel 
Command Qualifiers 


/ACCESSED:n 
/DENSITY:arg 

800 

1600 

6250 
/EXTENSION:n 
/FILE_ PROTECTION: code 
/OWNER: [g,m] 
/MAXIMUM FILES:n 
/PROTECTION:code 
/ [NO] SHOW 
/LABEL:newvolumelabel 
/WINDOWS:n 


Command Qualifiers 
/ACCESSED:n 


Specifies the approximate number of directories that will be 
accessed simultaneously during the mount. Legal values for n 
range from 1 through 127. FIIACP maintains a list of most 
recently used directories. The value specified for /ACCESSED 
sets the number of entries in this list. 


In general, directory operations can be significantly speeded up 
by increasing this value. If a directory appears in the list, no 
disk I/O is required to find the directory in the MED. In 
addition, directory operations take place without the necessity 
of reading the directory file header. Note that increasing the 
/ACCESSED value increases the amount of system pool used. 


/DENSITY:arg 
800 
1600 
6250 


Alters the /DENSITY value established when the volume was 
initialized. See the description of the /DENSITY qualifier under 
INITIALIZE (Section 5.8) for more information. 


/EXTENSION:n 


Specifies the number of blocks by which a file will be extended 
if it has exhausted its space allocation. n can be from 1 
through 127. The default is set by your system manager. 
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/FILE PROTECTION: code 


Specifies the protection for new files created on the volume. 
See Section 4.1.5 for more information on file protection. 


/OWNER: [g,m] 


Specifies the owner of the volume. See Section 5.1.4 for more 
information. 


/MAXIMUM_FILES:n 


Specifies the maximum number of files permitted on the volume. 
This value must be greater than the maximum value on the current 
volume. See the discussion of /MAXIMUM FILES under MOUNT for 
more detailed information on the maximum number of files 
permitted on various media. 


/PROTECTION: code 


Specifies the volume protection for the volume, See Section 
4.1.5 for more information on volume protection. 


/ [NO] SHOW 
Specifies that the information about the volume whose home block 
is being updated is to be displayed on your terminal. /NOSHOW is 
the default. 


Here is the display format for disks and other random-addressable 
devices: 


Volume Information 


Class: Files-11 or Foreign 

Device: ddnn: 

Volume label: label 

Pack Serial: serial number supplied by manufacturer 
Owner: {g,m] 

Protection: code 

Default: code 

Processor: acpname 


The owner field indicates the owner of the volume. The UIC must 
be matched for protection checks for owner privileges. The owner 
UIC can be changed with the /OWNER qualifier. See Sections 5.1.3 
and 4.1.5 for more information. Protection indicates volume 
protection; Default indicates file protection. 


/LABEL:new volumelabel 


Permits you to change the volume label. Volume labels can be as 
many as 12 characters. See the discussion of volume labels under 
MOUNT (Section 5.6) for more information about volume labels’ and 
which characters can be included. 


/WINDOW:n 
Specifies the default number of mapping pointers to be allocated 
for file windows when the file is accessed. A file window 


consists of a number of mapping pointers stored in memory when 
the file is opened. Legal values for n range from 1 through 127. 
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Notes 


INITIALIZE/UPDATE invokes the HOME WELL. See the 
RSX-11M/M-PLUS MCR Operations Manual. 


You should not use INITIALIZE/UPDATE without a good understanding 
of the Files-1l1 disk volume structure and a clear idea of the use 


the system makes of the values in the volume home _ block. For 
more information, see the IAS/RSX I/O Operations Reference 
Manual. 


Error Messages 
INITIALIZE/UPDATE shares many error messages with INITIALIZE. 


<bel1>***ATTENTION***<bell> 


This volume is operating with a replacement home block. 
Please take the action outlined in the documentation. 


Explanation: The HOME utility could not ensure that a good home 
block will be written on the volume, so it has placed an 
alternate home block on the first free block on the MOUNT search 


path. The new home block is not allocated to or mapped by any 
file. 


User Action: Copy the volume using BACKUP (BRU) or DSC before 
initiating any further operations. Otherwise, the replacement 
home block could be destroyed, making the data on the volume 
unrecoverable. 


INI -- Failed to find home block 
Explanation: HOME could not locate the home block of the volume. 


User Action: Reenter the command, including /SHOW to determine 
whether it is a foreign volume or not. See your system manager 
for further help. 


INI -- Failed to place alternate home block 


Explanation: When HOME cannot ensure that a good home block will 
be written back to the volume, it attempts to place an alternate 
home block on the first free block of the MOUNT Search path, 
This message indicates the attempt failed. 


User Action: The message may indicate a hardware problem, most 
commonly that the device is write-locked. See your system 
manager. 


INI -- MXF less than or equal to the existing value 
Explanation: The value specified in the /MAXIMUM FILES qualifier 
was less than or equal to the value already specified for the 


volume. 


User Action: Reenter the command specifying a /MAXIMUM FILES 
value larger than the current one. 
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5.9 BACKUP 


BACKUP backs up and restores Files-1ll volumes. It transfers files 


from a volume to a backup volume and retrieves files from the backup 
volume. 


The data is directed to a volume (or volumes) during a backup 
operation. More than one backup set can be contained on a tape or 
disk, or a backup set can extend over several tapes or disks. 


Format 


BACKUP [/qualifiers] 
From? sourceddnn: [filespec[s] ] 
To? destinationddnn: 


BACKUP [/qualifiers] sourceddnn:[filespec[s]] destinationddnn: 
Command Qualifiers 
Group 1: Selective Backup and Restore 


/CREATED: BEFORE: (dd-mmm-yy nn:mm) 
AFTER: (dd-mmm-yy nn:mm) 
/ EXCLUDE 
/IMAGE:arg 
SAVE 
RESTORE 
/NEW VERSION 
/MODIFIED:BEFORE: (dd-mmm-yy nn:mm) 
AFTER: (dd-mmm-yy nn:mm) 
/ [NO] REPLACE 


Group 2: Initialization 


/INITIALIZE 
/BAD BLOCKS:arg 
~ AUTOMATIC 
MANUAL 
‘OVERRIDE 
/ACCESSED:n 
/EXTENSION:n 
/HEADERS :n 
/MAXIMUM FILES:n 
/INDEX:arg 
BEGINNING 
MIDDLE 
END 
n 
/FILE PROTECTION: code 
/WINDOWS :n 
/SAVE SET:name 
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Group 3: Tape Control 


/ APPEND 
/DENSITY:arg 

800 

1600 

6250 
/ERROR LIMIT:n 
/LENGTH:n 
/ REWIND 
/LABEL: TAPE: fileset-ID 


Group 4: Verification 


/ COMPARE 
/VERIFY 


Group 5: Display 


/ [NO] LOG 
/LIST 


Group 6: Disk Processing 


/DIRECTORY 
/LABEL: INPUT: volumelabel 
/NOINITIALIZE 

/MOUNTED 

/ [NO] PRESERVE 

/LABEL: OUTPUT: volumelabel 


Parameters 
sourceddnn: 


Specifies the name of the device on which the input volume 
containing the data to be transferred has been placed. 


For tapes and disks, if you are using the /IMAGE qualifier, you 
may specify in the following format, more than one input device 
for tapes and disks: 
>BACKUP MMOt> MMLis MM: 
or 


*BACKUP DUOss DUit, DUS! 


You can specify as many as eight drives on each command, but you 
can specify a particular tape or disk drive only once. 


destinationddnn: 


Specifies the name of the device on which the output volume to 
which data is being transferred has been placed. 


For tapes and disks (if you are using the /IMAGE qualifier), you 
can specify more than one output device separated by commas, as 
described above. 
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filespec 


Indicates the file specification used to select particular files 
or categories of files to be backed up or restored. 


A filespec takes the form: 
[g,m] filename.typ;version 
You can specify as many as 16 filespecs per command. 
Files can be backed up or restored selectively by UFD, file name, 
file type, or version number. Note, however, that BACKUP does 


not accept 0 or -l as version numbers. 


When you enter a command without a file specification, all the 
files on the input volume are copied to the output volume. 


Any filespec field that is not specified is taken as a wildcard. 
If you do not specify version number, all versions will be 
assumed; if you specify only type, all files of all names and 
all versions of that type will be assumed; and so forth. 

Command Qualifiers 


Unless otherwise noted, the defaults for these qualifiers are the 
same as the equivalent attributes of the input volume. 


RACKIIP provides six aqronps of command qualifiers: 
e Selective Backup and Restore 
e Disk Initialization 
@e Tape and Disk Control 
e Verification 
e Display 
e Disk Processing 
Group 1: Selective Backup and Restore 


/CREATED: BEFORE: arg 
AFTER: arg 


Specifies selection of files created before or after the date and 
time given by arg. 


The required date/time argument can be in several formats. You 
must specify either a date or atime or both. If you do not 
specify a date, the default is today. If you do not specify a 
time, the default is now. Here are some examples: 


/BEFORE: 31-JUL-82 
/AFTER: 14:00 

/BEFORE: (1-APR-82 12:00) 
/AFTER: (1-APR-82 12:00} 
/BEFORE: 4/1/82 

/AFTER: (4/1/82 12:30) 
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Note that if you wish to enter both a date and a time, you must 
use the parentheses. These formats are used wherever you specify 
a date or a time or both in a BACKUP command. 


/ EXCLUDE 


Specifies that all files specified with the source device are to 
be excluded from the backup or restore operation, instead of 
included in it. For example, the command 


~BACKUP/EXCLUDE DBOSC SOG» 438.K MG? 
transfers all files except those in the UFD [306,6]. 


/IMAGE:arg 
SAVE 
RESTORE 


Specifies that you want to do a multiple disk-to-disk backup or 
restore operation. 


If you want to do a backup operation, you must use /IMAGE:SAVE 
when you create the backup file that represents the image copy of 
the input disk or disks. For example, this qualifier must be 
used when you copy a large disk to several small disks, or if you 
copy several small disks to a mounted large disk. 


If you are doing a restore operation, you must use /IMAGE:RESTORE 
if you are restoring from a backup file that represents the image 
copy of the original disk. 


/NEW_VERSION 


Specifies that a new version of the file be created in the event 
of conflicts that occur during restore operations and during 
backups to a mounted disk when using the /IMAGE:SAVE qualifier. 
Compare with /REPLACE. 


/MODIFIED:BEFORE:arg 
AFTERiarg 


Specifies selection of files modified before or after the 
specified date or time, or both. 


The required date/time argument can be in several formats. You 
must specify either a date or atime or both. If you do not 
specify a date, the default is today. If you do not specify a 
time, the default is now. Here are some examples: 


/ BEFORE: 31-JUL-82 
/AFTER: 14:00 

/BEFORE; (1-APR-82 12:00) 
/AFTER: (1-APR-82 12:00) 
/ BEFORE: 4/1/82 

/AFTER: (4/1/82 12:30) 


Note that if you wish to enter both a date and a time, you must 
use the parentheses. These formats are used wherever you specify 
a date or a time or both in a BACKUP command. 
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/ [NO] REPLACE 


Group 2: 


Specifies whether or not files from the input volume’ should 
replace files having identical file specifications on the output 
volume. 


A conflict occurs when a file on the input volume and a file on 
the output volume have identical file specifications. The 
default qualifier /NOREPLACE resolves that conflict by keeping 
the file on the output volume rather than replacing it with that 
on the input volume. A message informs you that the file has not 
been superseded. /REPLACE resolves the conflict by deleting the 
file on the output volume and replacing it with the file being 
restored from the input volume. 


Initialization 


/INITIALIZE 


/INITIALIZE specifies that you wish to initialize the output disk 
before proceeding with the data transfer. You must specify this 
qualifier if you wish to use any of the other initialization 
qualifiers discussed here. If you do not specify this qualifier, 
but specify other initialization qualifiers, you will be asked by 
a prompt whether you wish to initialize before proceeding or not. 
The default is /NOINITIALIZE. See the discussion in Group 6. 


See Section 5.8 for a description of INITIALIZE and its 


qualifiers. 


/BAD_ BLOCKS :arg 


AUTOMATIC 
MANUAL 
OVERRIDE 


Enters the locations of bad blocks on _ the volume being 
initialized. See Chapter 6 of the RSX-11M/M-PLUS Utilities 
Manual for more information on BAD, the Bad Block Locator 
Utility. 


/BAD_BLOCKS:AUTOMATIC 


Specifies that bad-block information for the volume be determined 
automatically from the file BADBLK.SYS, created by the BAD 
utility. This is the default. 


/BAD: AUTOMATIC is the default. 


/BAD_BLOCKS: MANUAL 


Specifies that bad-block information for the volume is to be 
entered manually. 


/BAD_BLOCKS: OVERRIDE 


This qualifier applies only to last-track devices. It makes’ the 
disk appear not to have bad-block information written in the last 
track, even if this information is actually present. 
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/ACCESSED:n 


Specifies the default number of File Control Blocks per volume to 
be kept in memory by the ACP. See the description of the 
/ACCESSED qualifer to MOUNT (Section 5.6) for more information. 


/EXTENSION:n 


Specifies the number of blocks by which the file will be extended 
when its allotted space is exhausted. 


/HEADERS:n 


Specifies the number of file headers to be allocated initially in 
the index file. 


The five system files (INDEXF.SYS, BITMAP.SYS, CORIMG.SYS, 
BADBLK.SYS, and 000000.DIR) are not included in the value for n. 


The default value for n is proportional to the capacity of the 
magnetic medium. See the description of /HEADERS in Section 5.8 
for information on the different magnetic media. 


/MAXIMUM_FILES:n 
Specifies the maximum number of files permitted on the volume. 


The value of n includes the five system files. The value of n 
must be less than or equal to the maximum value of n given in the 
description of /MAXIMUM FILES in Section 5.6. The description 
also includes the default value of n for each device. 


/INDEX:arg 
BEGINNING 
MIDDLE 
END 
n 


Specifies the location of the index file on the volume. This 
qualifier forces a specified location for the index file, the 
Master File Directory, and the storage allocation file. This is 
usually done to minimize access time. 


Four possibilities are available for the argument field: 


BEGINNING The beginning of the volume. This is the default 
for tapes and DECtapes. 


MIDDLE The middle of the volume. This is the default for 
disks. 

END The end of the volume. 

n Logical block n. 


The default position is the position of the file on the input 
volume. 
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/FILE PROTECTION: (code) 


Specifies the default protection for all files created on _ the 
volume being initialized. See Section 4.1.5 for more information 
on file protection. 


Default system protection code: 
(SYSTEM: RWED, OWNER: RWED, GROUP: RWED,WORLD:R) 


The default protection code is the protection code of the input 


volume 


Msc eo 


/WINDOWS :n 


Specifies the number of mapping pointers to be allocated for file 
windows. A file window consists of a number of mapping pointers 
stored in memory when the file is opened. 


The default is the number of mapping pointers on the input 
volume. 


See the discussion of the /WINDOWS qualifier in Section 5.6 for 
more information. 


/SAVE_SET:name 


Specifies the name of the backup set to be placed on tape or 
disk. For tapes and unmounted disks, the default name is the 
volume name for the disk being backed up. This name can be up to 
12 characters long. For an image backup or restore operation to 
a mounted input or output disk, you can specify the full backup 
set file name with /SAVE SET. If you do not specify a file name, 
the default name is [0,0]BACKUP.SYS. 


When you use /SAVE SET with an output volume, the backup set name 
becomes the name of the backup set being placed on the output 
volume. You can place multiple backup sets on a single volume. 


When you appiy /SAVE SET to an input tape volume, BACKUP searches 
the first tape for the specified backup set name. If you do not 
specify a backup set name with the input volume, when you do a 
restore operation BACKUP restores the first backup set it finds 
on the tape. You can restore several sequential backup sets from 
the same device without rewinding the tape between operations. 
BACKUP does not rewind the first device in a backup set unless 
you specify the /REWIND qualifier. 


When you apply /SAVE_SET to an input disk volume, BACKUP searches 
the entire disk for each backup set you specify. Each backup set 
is then restored in the order in which you provided the backup 
set names of the backup set names you provided. 
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Group 3: Tape and Disk Control 


/ APPEND 
Appends new data to a tape or disk that already contains one or 
more backup sets. If the tape is not positioned at the 
beginning, /APPEND causes output to be written where the tape is 
currently positioned. If you want to start writing at logical 


end-of-tape, you must specify /APPEND/REWIND, which rewinds’ the 
tape and then spaces forward to the end of the volume, 


If the output device is a disk, and you are using the /IMAGE 
qualifier, /APPEND causes BACKUP to check the container file 
header for the logical end-of-file on the output disk. BACKUP 
then starts writing at the logical end-of-file. 


You cannot use the /APPEND qualifier during a backup operation to 
a mounted disk. 


/DENSITY:arg 
800 
1600 
6250 


Specifies the density in bits per inch (bpi) for the medium 
loaded on the device. See Section 5.6 for a list of acceptable 
densities for DIGITAL devices. 
The default is 800 bpi. 

/ERROR LIMIT:n 


Specifies the number of nonfatal I/O errors that BRU tolerates on 
tape reads before terminating execution. 


The default value for n is 25. 
/LENGTH:n 


Specifies the length of the output tape in decimal feet. You may 
want to use this qualifier when you know that the last part of a 


tape is defective and must not be used. You can specify a 
shorter length and ensure that you do not write on that part of 
the tape. 


The default length is the physical length of the output tape. 
/ REWIND 


Rewinds the first tape of a tape set before executing the command 
line. 


See /APPEND for further information on /REWIND. 
/LABEL: TAPE: fileset-ID 


Specifies a 6-character ANSI fileset-ID. On output operations 
this ID is written on the tape. On input operations the ID is 
compared with the ID already on the input tape to ensure that you 
have mounted the correct tape. 
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Group 4: Verification 


The following qualifiers allow you to verify the accuracy of data 
transfers. 


/COMPARE 


Compares the data on the output volume to the data on the input 
volume and reports any differences. /COMPARE does not copy any 
data. See /VERIFY. 


You must compare equivalent volumes. You can assure that the 
volumes are equivalent by including the /COMPARE qualifier ina 
command that is otherwise identical to the BACKUP command that 
was entered when the output volume was created. 


The restriction does not apply to the /[NOJINITIALIZE and 
/COMPARE qualifiers. 


/VERIFY 


Copies data from the input volume to the output volume, then 
performs a compare operation, and reports any differences. 


Group 5: Display 


The following qualifiers display information about the data 
transferred. 


/ {NO]LOG 


Displays at your terminal the UFD and file name of each file 
being backed up or restored. /NOLOG is the default. 


/LIST 


Displays at your terminal the backup set names or files on _ the 
specified tape or disk volume. In a multivolume tape set, the 
directory is on the first tape of a set. Ina multivolume disk 
set, the directory is on the first disk of the set. See the 
example. 


Group 6: Disk Processing 


The following qualifiers allow you to control the way the 
operating system manages disk data transfer operations. 


/DIRECTORY 
Directs BACKUP to create UFDs (if they do not already exist) ona 
mounted output volume, then copy into the UFDs the files from the 
same UFD on the input volume. If you do not specify /DIRECTORY, 
BACKUP does not copy the file. /DIRECTORY is used only with the 
/NOINITIALIZE qualifier. 


/LABEL: INPUT: volumelabel 
Specifies the volume label of the input disk. This is not a 


required parameter; if you specify it, however, BACKUP checks 
the vclume label, 
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/NOINITIALIZE 
Specifies that you do not want to initialize the output disk, as 
it already contains a Files-ll structure and is mounted as a 
Files-11 volume. 


/ MOUNTED 


Allows you to back up files from a disk that is mounted as 
Files-ll. Transfers are faster from an unmounted volume. 


/ [NO] PRESERVE 
/NOPRESERVE specifies that you do not want BACKUP to preserve 
file identifiers during a disk-to-disk transfer. The default is 
/PRESERVE. 
/LUABEL: OUTPUT: volumelabel 
Specifies a volume label for the output disk. 
The default label is the label of the input volume. 
Examples 
>BACKUP/LABELSINFUTIRANDOM/SAVE SETI LS JULE2 
From? DRO¢ 
To: MMO: 
BAC - Starting tere Lo am HMO} 
BAC - End of tare 1 am MMO; 
BAC ~ Completed 
This example transfers all files on the RKO5 disk labeled RANDOM 
to the tape mounted on MMO:. The backup set name 19JUL82 
identifies the data written on the output tape. 
“BACKUP /SREWINOSSAVE_LSETILGJULSGS/NOINITIALIZE MMOD De? 
This example rewinds the tape on drive MMO:, then locates’ the 
backup set with the name 18JUL82 (there may be more than one 
backup set on a tape) and transfers all files in the backup set 


to DMO: which is mounted and has a Files-ll structure. The 
/NOINITIALIZE qualifier instructs BACKUP not to initialize DMO:. 


=BACKUP/LIST Nit: 


VOL1 PGdULES! GANT. Aes cba 
YOLI4 BACKUPS INF SS de JUL e ae 
VOL1 19JULS82 FANDOM 19 - tube 


This example shows a directory of a tape volume. It displays the 
tape volume number, VOL1, the names of three volumes, and three 
backup sets contained on the tape. 
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BACKUP can also be used to display the names of the files in a 
given backup set by specifying the backup set name along with the 
/LIST qualifier, as in the following example: 


~BACKUF/SAVESETSISIULG2/LIST HMO: 
VOL1 19JULS2 RANDOM 29-JUL-82 S233 7t11 
C303r13) 

2/DECE«LST#1 

ASTCRSH. MACS 2 

AFNOXC. TXT 1 

X+OBJ1 

A+TEKRS 

X+MAF FL 

30656) 

27ECE.CuAsL 

RSALIN.STERES 


BAC ~ Comeleted an MMG? 
Notes 
The BACKUP command invokes BRU, the Backup and Restore Utility. 
For more information on BRU, see Chapter 7 of the RSX-11M/M-PLUS 
Utilities Manual. 
You must specify either /INITIALIZE or /NOINITIALIZE. If you 
specify neither, BACKUP will ask if you wish to initialize the 


output device. 


BACKUP is not a privileged command, but you should not use it if 
you are not familiar with BRU. 


Error Messages 


For many nonfatal errors, BACKUP continues with the operation, 
but prints a warning message such as the following: 


BAC -- *WARNING* APPENDING AT 800 BPi 

BAC -- *WARNING* BOOT BLOCK IS BAD 

BAC -- *WARNING* CANNOT RESTORE CONTIGUOUSLY 

BAC -- *WARNING* EOT MARKER ERROR 

BAC -- *WARNING* FILE IDS WILL NOT BE PRESERVED 

BAC -- *WARNING* NONFATAL QUALIFIER CONFLICTS BEING IGNORED 


These and other warning messages are explained in Chapter 7 of 
the RSX-11M/M-PLUS Utilities Manual. 


BACKUP also issues purely informational messages such as_ the 
following: 


Completed 


Starting tape n on ddnn: 


HANDLING DEVICES AND VOLUMES 


BACKUP (Cont.) 


These messages require no response. 


BACKUP requests response from the user:with messages such as_- the 
following: 


Please answer Yes or No 

Mount another tape 
The following are the most common error messages from BACKUP. 
Other error messages are described in the RSX-11M/M-PLUS 
Utilities Manual. 

BAC -- *FATAL*-Allocation for sys file exceeds volume limit 
Explanation: One of the five files created when a volume is 
initialized does not fit on the output disk. This message 
usually occurs when the output disk is smaller than the input 
disk. 


User Action: Reinitialize the disk using the /INDEX:BEGINNING 
qualifier to BACKUP or INITIALIZE to force the allocation to 


Start at the beginning of the disk. You can also use _ the 
/MAXIMUM FILES or /HEADERS qualifiers to reduce the size of 
INDEXF.SYS. 

BAC -- *FATAL*-Attach failed on ddnn: 


Explanation: BRU could not attach the specified device. 


User Action: Check to see if another task has the device 
attached, or if the device has a volume mounted on it. 


BAC -- *FATAL*-Device conflict 


Explanation: Command specified both a tape and a disk drive as 
part of the input or output device specification. 


User Action: You can specify either a disk or a tape but not 


both. Check command for proper device names and reenter the 
command. 
BAC -- *FATAL*-Device not in system 


Explanation: Command specified a device that is not part of the 
current system. 


User Action: Check command for proper device names and reenter. 
BAC -- *FATAL*-Device not supported 


Explanation: Command specified a device that is not a tape or 
disk. 


User Action: Check command for proper device names and reenter. 
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BAC -- *FATAL*-Disk read error 


Explanation: An unrecoverable read error occurred on the output 
disk. This error could be caused by an undetected bad block. 


User Action: Run BAD on the disk and then use BACKUP with the 
/BAD_BLOCKS: AUTOMATIC qualifier. 


BAC --— *FATAL*-Disk write error 


Explanation: An unrecoverable write error occurred on the output 
disk. This error could be caused by an undetected bad block. 


User Action: Run BAD on the disk and then use BACKUP with the 
/BAD_BLOCKS: AUTOMATIC qualifier. 


BAC-- *FATAL*-End of volume encountered. Backup set not found 


Explanation: The backup set specified for a restore operation is 
not on the tape volume. 


User Action: Mount the correct tape volume and retry the 
operation. 


5.10 SET AND SHOW 


You can display assignments and set and display certain device 
characteristics. 


5.10.1 SHOW ASSIGNMENTS 

SHOW ASSIGNMENTS displays at your terminal all local and _ login 
logical-device assignments. Privileged users can display assignments 
from other terminals and global assignments. 


Logical-device assignments are established by ASSIGN, by SET DEFAULT, 
and by ACNT, the Account File Maintenance Program. 


Format 
SHOW ASSIGNMENTS [/qualifier] 
Command Qualifiers 
/LOCAL 
/GLOBAL 
/TERMINAL:ttnn: 
/LOGIN 
/SYSTEM (synonym for /GLOBAL) 


Parameters 


None. 
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Specifies that local and login logical assignments from your 
terminal are to be displayed on your terminal. This is the 
default. 


/GLOBAL 


Specifies that all logical assignments in the system, including 
global assignments, are to be displayed on TI:. This is a 
privileged qualifier. 


/TERMINAL:ttnn: 


Specifies that local and login assignments from terminal ttnn: 
are to be displayed on TI:. This is a privileged qualifier. 


/LOGIN 


Privileged qualifier included for completeness. For all 
terminals, this qualifier is the same as /LOCAL. 


Examples 
>SHOW 
Fumetion? ASSIGNMENTS 
LFO? DOKL: LOCAL TPP is 
TPOt TVtTA4 LOCAL TI ~ TTii? 
SYO? DBL: LOGIN Th = TTY 


This example shows the display for a user who has used ASSIGN to 
assign local logical names to a number of devices. These logical 
names can be used in place of the device names. The logical name 
is displayed on the left and the physical device name (or pseudo 
device name) is on the right. The type of assignment -- LOCAL or 
LOGIN -- is given, and the TI:. Output to LPO: will actually go 
to DKl:. In this case, the logical name takes the place of a 
physical device name. The user cannot direct output to physical 
LPO?.. Output tov Ted; .will go to: TT1LI¢e; ‘which .1s. “Tis, In 
addition, the user has the login assignment of SY0: to DBI:. 
This means that DBl: is the default device for this user. 


“SHOW ASSIGNMENTS/LOCAL 


This example is the equivalent of the previous example. 


“SHOW ASSIGNMENTS/TERMINALITT373 
MFO? SYO% LOCAL it ee came ae Se 
SYO? SYO% LOGIN Bt coed Oe a4 


This example, which requires a privileged terminal, displays’ the 
logical assignments from terminal TT37:. This user has given the 
local logical name MPO: to the pseudo device, SYO:. The login 
assignment gives the login logical name SY0: to the pseudo 
device SY0:. Sy0: is the name of the defauit device. 
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>SHOW ASSIGNMENTS/GLOBAL 


SYO: DB1: LOCAL TI - TT42: 
SYO: DB1: LOGIN TI - VT4: 

SYO0: SY0: LOGIN TI - TT4: 

SY0: SY0: LOGIN TY +~ TT15: 
WKO: LBO: GLOBAL 

INO: SY0:% GLOBAL 

EX0: SYO: GLOBAL 


This example, which requires a privileged terminal, displays all 
logical assignments for the entire system. 


5.10.2 SET DEVICE 


SET DEVICE establishes certain device attributes. With the exception 
of SET DEVICE:TI:/WIDTH:n, this is a privileged command. 


Format 


SET DEVICE 
Device? ddnn: 
Attribute? attribute 


SET DEVICE:ddnn:/attribute 
Device Attributes 


/{NO]CHECKPOINT FILE:n 
/ [NO] LOWERCASE 

/{NO] PUBLIC 

/ {NO]SYSTEM 

/WIDTH:n 


Parameter 
DEVICE:ddnn: 


Specifies the device for which attributes are to be set. Note 
that, when the one-line form of the command is’ used, the 
parameter is ddnn: preceded by a colon (:) at the end of the 
word DEVICE. 


Device Attributes 
/(NO]CHECKPOINT FILE:n 


The /CHECKPOINT FILE:n attribute sets aside n (decimal) blocks on 
the specified volume in [0,0]CORIMG.SYS, the checkpoint file. 
The volume must be in Files-1l format. Only one checkpoint file 
is permitted on each volume, but several volumes may have 
checkpoint files. The system searches for checkpoint files in 
the order they were created. If space is not available in the 
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first checkpoint file created (the primary file), the system 
searches in the second file to be created, and so on. Checkpoint 
files can be allocated on volumes mounted on private devices. In 
general, the system should have checkpoint space equal to twice 
the total amount of memory that all running tasks are using. 


The /NOCHECKPOINT FILE attribute makes the checkpoint file 
unavailable. If the specified file contains checkpointed tasks, 
the file is not deactivated until the tasks have returned to 
memory, but no new tasks will be checkpointed to the file. The 
checkpoint file is still on the volume but is zero blocks long. 


/ [NO] LOWERCASE 


The /LOWERCASE attribute sets a terminal or line printer so that 
lowercase characters are not converted to uppercase for printing. 


The /NOLOWERCASE attribute sets a terminal or line printer so 


that lowercase characters are converted to uppercase for 
printing. This is the default. 


Nonprivileged users can use the SET TERMINAL/LOWERCASE command to 
set TI: in this fashion. 


/{NO] PUBLIC 
/ [NO] SYSTEM 


The /PUBLIC attribute sets the device as a public device. This 


command also mounts the device. Public devices are accessibie to 
all users. 


The /NOPUBLIC attribute removes the public status of a device. 
This is the default setting. 


/({NO]SYSTEM is a synonym included for VAX/VMS compatibility. 


Section 5.1.3 contains a discussion of public and private 
devices. 


/WIDTHin 


Sets the size of a device's I/O buffer. The value of n (decimal) 
is the length in characters of a line on the device. 


For line printers, n must be greater than 0 and not greater than 


255. The line-printer driver discards all characters in a record 
(line) that do not fit in the I/O buffer. 


For terminals, n must be greater than 2 and not greater than 255. 
The terminal driver does not discard excess characters, but puts 
them in a record of their own. That is, excess characters appear 
one line below the line in which they should appear. 


Nonprivileged users can set the width of their terminals using 
this command or SET TERMINAL/WIDTH:n. 
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Examples 
=SET 
Fumetion? DEVICE 
Device? LFIt 
Attribute? WIDTH! 8o 
This example sets the I/0 buffer size (line length) to _ 80 
(decimal) characters on the line printer LPIl:. 
’SET DEVICES LFA /LOWERCASE 
This example sets LPl: so that all lowercase characters sent to 
it will be printed in lowercase. The command must be issued even 


if the printer is controlled by the Queue Manager and has. been 
initialized lowercase. 


PSET DEVICEIUBZ! /CHECKPOINTOFILE 1256 


This example creates a checkpoint file of 256 (decimal) blocks on 
DB3:. 


Notes 

SHOW DEVICES displays the attributes set by SET DEVICE. 
Error Messages 
SET -- Feature not supported 


Explanation: The command specified an optional feature that was 
not incorporated into the system at system generation. 


User Action: See your system manager. 
SET -- Pseudo device error 
Explanation: Command attempted to set a pseudo device public. 


User Action: A pseudo device cannot be set public. Retype 
command using physical device name. 


SET -- Write check not supported 


Explanation: Command attempted to enable write-checking on a 
device that does not support it. 


User Action: Write-checking is not supported on magnetic tapes, 
RLO1ls, or RXOls. 


5.10. 


SHOW 
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3. SHOW DEVICES 


DEVICES displays information about the devices included in the 


system. 


Format 


SHOW DEVICES [/attribute] 
Device Attributes 


/dd{nn}: 

/ {NO] PUBLIC 

/WIDTH:ddnn: 

/[NO]SYSTEM (synonym for /PUBLIC) 


Device Attributes 


If you do not include an attribute, SHOW DEVICES displays a list 


of all the devices on the system, including terminals and pseudo 
devices. 


/ [NO] PUBLIC 
/{NO]SYSTEM 


Displays a list of all devices set (or not set) PUBLIC. 
/{NO]SYSTEM is a synonym included for VAX/VMS compatibility. 


/dd[nn]: 


Displays information about all devices of a particular type on 
the system. dd: is the 2-letter device mnemonic terminated with 
a colon, which indicates the type of device controller. The 
display shows the devices under that type of controller by model 
name. 


The command SHOW DEVICES/dd[nn:] is useful when you plan to 
allocate a drive, as it shows you which drives are available. 
Since the same controller may control devices whose disks are not 
interchangeable, a generic allocate (ALLOCATE DB) may allocate a 
device which cannot accept your disk. See examples. 


/WIDTH:ddnn: 


Displays the size of the I/0 buffer (line length) for a 
particular device, including a terminal. 


Display Information 


ddnn: 


The display from SHOW DEVICES can include a number of messages. 


A device name in the first column indicates the device or pseudo 
device for which information is being displayed. A device name 
in the second column indicates a device to which the 
corresponding device in the first column has been redirected 
(logically assigned). 
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TTnn: 


A terminal name in the second column, followed by the word 
PRIVATE, indicates that the device named in the first column has 
been allocated by the user logged on to the terminal in the 
second column. 

MOUNTED 


Indicates that the device is mounted. For privileged users, the 
message also includes the volume label. 


BUF= 

Indicates the line length (I/O buffer size). 
PUBLIC 

Indicates that the device has been set public. 


If your command was SHOW DEVICES /PUBLIC, or /NOPUBLIC, the 
display is PUB=ddnn: or NOPUB=ddnn: 


TYPE= 
Indicates the device type by model name, for example, RLO1l, RX02. 
If you wish to display devices by type, use the 2-letter device 
mnemonic. 

MARKED FOR DISMOUNT 
Indicates that a mounted device has been marked for dismount, but 
that the dismount has not been completed, meaning that files are 
still open on the volume. The volume can be remounted while it 
is marked for dismount. 


OFFLINE 


Indicates that the system tables contain entries for the device, 
but that it is not included in the current configuration. 


{g,m] LOGGED ON 


Indicates that the user identified by [g,m] is logged on to the 
terminal. 


LOADED 

Indicates that a loadable device driver is currently loaded. 
UNLOADED 

Indicates that a loadable device driver is currently not loaded. 
SPOOLED 


Indicates that a device is under the control of the Queue 
Manager. 
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WCHK= 
NOWCHK= 


Indicates a device with write-checking enabled or not enabled. 
Examples 


SHOW DEVICES 


DO} FUBLIC MOUNTED LOADED TYFE=RPG6 

DBL: PUBLIC MOUNTED LOADED TYFE=RFO6 

WEe3 FUBRLIC LOADED TYFE=RFO4 

DES: PUBLIC MOUNTED LOADED TYFE=RFO6 

DRG 5 YTSi - PRIVATE MOUNTED LOADED TYPE=RMOS 
DRL? LUADEL TYFE=RMNOZ 

WRG? LOADED 

LFO? YeO? SFOOLED LOADED 

LPis DRO? SPOOLED LOAnEn 

COO, TIG; 

TTGs LGADED 

ribs C7s4G] Cirid ~ LOGGED ON LOATED 

TT23 C7740] (€14710] - LOGGED ON LOALTED 

Lis C2Z03:54 £30325] - LOGGED ON LOALED 
TT4é3 LOATED 

TTé?7% LOATIED 

MILO 3 LOATED 

VTO? LOATEL 

Vis LOADED 

YT23 Cisid Cisid -~ LOGGED ON LOADED 
VT4; C3035] C3035] ~ LOGGED ON LOALED 
TIO; 

ULOS TTO3 

SFO: DRO: 

LO 3 DRO? 

SYO? DROS 


This example shows the display from SHOW DEVICES. All devices 
and pseudo devices are included. For terminals, the first [g,m] 
field is the login UIC and the second is the default UFD. The 
only information shown for pseudo devices is the name and the 
device to which they are redirected. Privileged users also see 
volume labels. 


“SHOW DEVICES DR? 


HO} FUBLIC MOUNTED LOADED TYFE=RFO6 
BiG FUBLIC MOUNTED LOADED TYPE=RFO06 
E23 PUBLIC LOANED TYPE=KFO4 

NBS: FUBLIC MOUNTED LOADED TYFE=RFO4 


This example displays information about all devices of the type 
DB:. The mnemonic (DBnn:) identifies the device controller and 
the model name (RP04) indicates the physical device type. RPO4 
disks do not fit RP06 drives, even though the device controller 
is the same. 
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"SHOW DEVICES “PUBLIC 
PUBEIEBO ? 
PUBS OBL 
Puke Dib 2 3 
PURE DRS 
FUBPFISOS 
Puss Ded: 
SUL POY 
PUBSLEP Ts 


This example displays information about all public devices. 
Public devices are accessible to all users. They may be mounted 
by any user to assure continued access to the volume mounted on 
the device. 


PSHOW NEVICESLPO? “WIDTH 
RUFELPOSCOLS2, 
SHGWU TEVICES TTL /WIOTH 
BUFFS TTiL?oo080, 


This example displays the line lengths of a line printer and a 
terminal. The line length is determined by the size of the I/0 
buffer, which is established through SET DEVICE:ddnn:WIDTH. 


CHAPTER 6 


PROGRAM DEVELOPMENT 


6.1 INTRODUCTION 
Program development on RSX-1LIM/M-PLUS is accomplished in four steps: 


1. Creating a program in a supported source language using an 
editor 


2. Compiling or assembling the source program to create a binary 
object file 


3. Turning the object file into a runnable task image using the 
Task Builder 


4. Running the program as a task on the system 


If you are not familiar with the rudiments of this process, see the 
Introduction to RSX-11M and RSX-11M-PLUS. 

To create a source program, you must’ be familiar with the 
file-creation facilities of the system discussed in Chapter 4 of this 
manual. You will also need knowledge of one of the programming 
languages available on your system. 


Commands described in this chapter on program development include 
commands directed to various language compilers or interpreters and 
the MACRO-11 Assembler, commands for maintenance of libraries used by 
programs, and the LINK command, which controls the operation of the 
Task Builder. 


RSX-11M/M-PLUS systems offer extensive program development facilities. 
These facilities are introduced in the RSX-11M/M-PLUS Guide to Program 
Development. This manual introduces the most important software tools 
used in program development and takes you through the program 
development process in considerable detail. 


RSX-11M and RSX-11M-PLUS support a number of programming languages, 
also called source languages. Not all of these languages are 
available on all systems, but all systemS have one or more source 
languages available. 
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MACRO 


For each language or language group, there iS a DCL command. The 
MACRO command gives access to the MACRO-11 Assembler. The BASIC 
command gives access to either the BASIC-11 interpreter or _ the 
BASIC-PLUS-2 interactive compiler. The FORTRAN command gives access 
to the FORTRAN-IV, FORTRAN-IV-PLUS, and FORTRAN-77 compilers. The 
COBOL command gives access to the PDP-11 COBOL and COBOL-81 compilers. 
The CORAL command gives access to the CORAL 66 compiler. 


Documentation is available for all DIGITAL-supplied languages included 
in your system. Your system may also have other languages not 
described here. See your system manager for information on the 
languages availabie at your instailation. 


All systems include the MACRO-11 Assembler for processing MACRO-11 
source code. MACRO-11 is the assembly language for PDP-11l computers, 
but this language includes many features considered the province of 
high-level languages. MACRO-11 is named for its capacity to use 
macros, where a single line of code can stand for a long series of 
assembly-language instructions. 


Regardless of your usual programming language, you should look into 
MACRO-11. MACRO-11 is capable of doing anything that can be done on a 
PDP-11. All DIGITAL-supplied high-level languages have the means’ for 
incorporating MACRO-1ll routines. Since the high-level languages are 
designed for use on computers from many different manufacturers, some 
functions that are difficult to achieve in a generalized high-level 
language may be easier to perform in MACRO-11, which is designed 
specifically for PDP-lls. 


In addition to the RSX-11M/M-PLUS Guide to Program Development, you 
should review the following manuals for information on MACRO-11 
programming on RSX-11M or RSX-1LIM-PLUS: 


e PDP-11 MACRO-11 Language Reference Manual, which describes 
assembly-language programming. 

e IAS/RSX System Library Routines Reference Manual, which 
describes the routines used by system tasks on RSX-11M and 
RSX-11M-PLUS. These routines can be included in programs. 


@e RSX-11M/M-PLUS Executive Reference Manual, which describes 
system directives and their processing. You can call 
Executive routines in your programs. 


@e PDP11/xx Processor Handbook. Describes each PDP-1ll model, 
including its instruction set. 


6.2.1 MACRO 

MACRO invokes the MACRO-11 Relocatable Assembler, which assembles one 
or more MACRO-11 source files into a single relocatable object module 
suitable for processing by the Task Builder. 


Format 


MACRO[/qualifier[s]] filespec[/qualifier[s]] [,filespec[,s]] 
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Command Qualifiers 


/[NO]CROSS_ REFERENCE 
/DISABLE: (arg[,s]) 

ABSOLUTE 

BINARY 

CARD FORMAT 

GLOBAL 

LOCAL 

LOWERCASE 

REGISTER DEFINITIONS 

TRUNCATION 
/ENABLE: (arg[,s]}) 

ABSOLUTE 

BINARY 

CARD FORMAT 

GLOBAL 

LOCAL 

LOWERCASE 

REGISTER DEFINITIONS 

TRUNCATION 
/(NO]LIST[:filespec}] 
/{NO] OBJECT[(:filespec] 
/{NO]SHOW[: (arg[,s])] 

ALL 

- BINARY 

CALLS 

COMMENTS 

CONDITIONALS 

CONTENTS 

COUNTER 

DEFINITIONS 

EXPANSIONS 

EXTENSIONS 

LISTING DIRECTIVES 

OBJECT BINARY 

SEQUENCE NUMBERS 

SOURCE ~— 

SYMBOLS 
/({NO]WIDE 


File Qualifiers 


/LIBRARY 
/PASS:in 


Parameter 
filespec{[s] 


Specifies input files for the MACRO-1l1 Assembler. These input 
files must contain MACRO-11 source code. Multiple filespecs must 
be separated by commas. Filespecs must include a file name. If 
no file type is given, the default file type (.MAC) is applied. 
If the parameter qualifier /LIBRARY is used, .MLB is the default 
file type. No wildcards are accepted by MACRO. 
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NOTE 


The MACRO-11 Assembler uses the name of 
the last file named in the command as 
the default name for output files. The 
last file named cannot be a library. 
All other language commands, and_ the 
LINK command, use the first file named 
in the command as the default name for 
output files. 


Command Qualifiers 
/(NO)LIST{:filespec] 


Specifies whether an assembly listing should be generated. The 
default is /NOLIST, meaning no assembly listing is generated. 


If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the last source 
file in the MACRO command with the file type .LST. If you wish 
the listing to have a different name, supply the name as an 
argument to the /LIST qualifier. If you do supply a name, the 
listing file appears in your directory but is not printed on the 
line printer. 


The /LIST qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /LIST is used as a command qualitier, the listing 
file is placed in your directory and printed on the line printer. 
If /LIST is used as a filespec qualifier, the listing file 
appears in your directory but is not printed on the line printer. 


If your command line includes the /CROSS REFERENCE qualifier, 
/LIST is implied and need not be specified. /CROSS REFERENCE as 
a command qualifier causes the file to be printed on the line 
printer; /CROSS REFERENCE as a filespec qualifier prevents the 
listing file from being printed. 


If your command line includes listing-control arguments to either 
/SHOW or /NOSHOW, /LIST is implied and need not be specified. 
/{NO]SHOW as a command qualifier causes the file to be printed on 
the line printer; /[NO]SHOW as a filespec qualifier prevents the 
listing file from being printed. 


The only time you need to use /LIST with /CROSS REFERENCE or 
/(NO]SHOW is when you wish to give the listing file a filespec 
other than the default. In such cases, the position of the 
qualifiers in the command line has no effect; the listing file 
appears in your directory but is not printed on the line printer. 


See the examples. 
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/{(NO] OBJECT[:filespec] 


Specifies whether an object module should be generated. The 
default is /OBJECT, meaning an object module is generated. If 
you do not supply a file specification, the object file has a 
name derived from the name of the last source file and the file 
type .OBJ. If you wish the object file to have a different name, 
give the name as an argument to the /OBJECT qualifier. 


You can name the object file after any of the source files listed 
in the MACRO command by using /OBJECT as a filespec qualifier. 
If used as a filespec qualifier, /OBJECT cannot take a filespec 
argument. 


The qualifier /NOOBJECT specifies that no object module is 
generated. You can use this qualifier if you wish to use other 
facilities of the assembler, to get an assembly listing, for 
instance, without doing the assembly. 


/{NO]CROSS_REFERENCE 


Specifies whether a cross-reference listing should be generated 
and appended to the assembly listing. The default is 
/NOCROSS REFERENCE. 


The cross-reference listing locates all user-defined and MACRO 
symbols that appear in the source program. 


Wnen you specify this qualifier, you are also specifying the 
/LIST qualifier by implication. An assembly listing is 
generated. It appears in your directory and is also printed on 
the line printer. If you wish to change the name of the listing 
file, you must use /LIST with a file specification in addition to 
/CROSS_REFERENCE. 


/CROSS REFERENCE as a command qualifier causes the file to be 
printed on the line printer; /CROSS REFERENCE as a filespec 
qualifier prevents the listing file from being printed. See the 
examples and the discussion under /LIST. 


/ENABLE: (arg[,Ss] ) 
/DISABLE: (arg[,s]) 


These qualifiers override the .ENABL and .DSABL assembler 
directives included in the source program being assembled. The 
-ENABL and .DSABL directives invoke or inhibit various aspects of 
the assembly. Table 6-1 summarizes the arguments to /ENABLE and 
/DISABLE and gives their MACRO-11 equivalents. There is a 
default setting for each of these directives, even if you do not 
specify them in your code or command line. 


These qualifiers affect the entire assembly. If, for example, 
your MACRO command includes the qualifier /ENABLE:LOWER CASE, the 
assembler does not convert any lowercase source text to 


uppercase, regardless of any .DSABL LC or .ENABL LC directives in 
the source code. The same goes for /DISABLE:LOWER CASE. All 
-ENABL or .DISABL LC directives are ignored. 
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If you specify only one argument to /ENABLE or /DISABLE, you need 
not include the parentheses, but if you have more than one 
argument, they must be separated by commas and enclosed in 
parentheses. 


Table 6-1 
The /ENABLE and /DISABLE Qualifiers 


Assembly Functions Disabled by Default 


ABSOLUTE AMA Enabling this function causes 
| 


relative mode addresses (mode 67) to 
be assembled as absolute addresses 


(mode 37). 

BINARY ABS Enabling this function produces 
absolute binary output in Files-1l 
format. 

CARD FORMAT CDR Enabling this function causes source 


columns 73 and greater to be treated 
as a comment. 

LOCAL LSB Enabling this function permits the 
disabling or enabling of a local 
symbol block. 


LOWERCASE LC Enabling this function causes 
MACRO-11 to accept lowercase ASCII 
input. The default is to convert it 
to uppercase. 


TRUNCATION FPT Enabling this function causes 
floating-point truncation. The 
default is floating-point rounding. 


Assembly Functions Enabled by Default 


REGISTER DEFINITIONS | REG Disabling this function inhibits the 
= normal MACRO-l1l default register 
definitions. The default is RO=%0, 
R1l=%1l . . . SP=%6,PC=%7. Under most 
circumstances, you should use these 
defaults. 


GLOBAL GBL Disabling this function causes 
MACRO-11 to treat all symbol 
references that are undefined at the 
end of Assembly Pass 1 as undefined 
symbols. The default is to treat 
all such symbols as global symbols. 
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/{NO]SHOW([: (arg[,s])] 


These qualifiers override the .LIST and -NLIST assembler 
directives included in the source program being assembled. The 
-LIST and .NLIST directives control the content and format of the 
assembly listing. Table 6-2 summarizes the arguments to /SHOW 
and /NOSHOW and gives their MACRO-11 equivalents. There is a 
default setting for each of these directives, even if you do not 
specify them in your code or command line. 


These qualifiers affect the entire assembly. If, for example, 
your MACRO command includes’ the qualifier /SHOW:COMMENTS, the 
assembly listing includes all comments, regardless of any .NLIST 
COM or .LIST COM directives in the source code. The same goes 
for /NOSHOW:COMMENTS. All .LIST COM or .DISABL COM directives 
are ignored. 

If you specify only one argument to /SHOW or /NOSHOW, you need 
not include the parentheses, but if you have more than one 
argument, they must be separated by commas and enclosed in 
parentheses. 


/SHOW implies /LIST, but if you wish the listing file to have a 
mame other than the default, you must still use /LIST. 


/SHOW as a command qualifier causes the file to be printed on the 
line printer; /SHOW as a filespec qualifier prevents the listing 
file from being printed. See the example and the discussion 
under /LIST. 


Table 6-2 
The /SHOW and /NOSHOW Qualifiers 


Listing Functions Disabled by Default 


EXPANSIONS 


Enabling this function causes 
MACRO-11 to include all macro 
expansions in the listing. 


Enabling this function causes 
MACRO-11 to list only those macro 
expansions’) that generate binary 
code. This is a subset of 
EXPANSIONS. 


cl 
) 


Enabling this function causes 
MACRO-11 to list all listing control 
directives without arguments, that 
is, those listing directives that 
alter the listing level count. 


(Continued on next page) 
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Table 6-2 (Cont.) 
The /SHOW and /NOSHOW Qualifiers 


SEQUENCE NUMBERS 


COUNTER LOC 
OBJECT BINARY BIN 
EXTENSIONS BEX 

| SOURCE | SRC 

| tte, 
COMMENTS COM 
DEFINITIONS MD 
CALLS MC 


CONDITIONALS 


CONTENTS 


SYMBOLS 


Listing Functions Enabled by Default 


Disabling this function suppresses 
the inclusion of sequence numbers in 
the listing. Sequence numbers are 
replaced by tabs. 


Disabling this function suppresses 
the location counter field and does 
not replace it with a tab. 


Disabling this function suppresses 
the listing of generated binary code 
and does not replace it with a tab. 


Disabling this function suppresses 
the listing of binary extensions, 
that is, all binary code that will 
not fit on the first line. This is 
a subset of OBJECT BINARY. 

| 


Disabling this function suppresses 
the listing of source lines. 


Disabiing this function suppresses 
the listing of comments. This is a 
subset of SOURCE. 


Disabling this function suppresses 
the listing of macro definitions and 
repeat range expansions. 


Disabling this function suppresses 
the listing of macro calls and 
repeat range expansions. 


Disabling this function suppresses 
the listing of unsatisfied 
conditional coding. 


Disabling this function suppresses 
the listing of table of contents 
during assembly pass 1. The full 
assembly listing is still prepared 
during assembly pass 2. 


Disabling this function suppresses 
the listing of the symbol table 
resulting from the assembly. 
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/{NO]WIDE 


Specifies whether you wish the assembly listing in wide or narrow 
format. The default can be set by your system manager. As 
supplied, the default is /WIDE, also called line printer format. 
/NOWIDE is sometimes called teleprinter format. 


This qualifier overrides any .LIST TTM or .NLIST TTM directives 
included in your source program. 


Parameter Qualifier 
/PASS:n 


Specifies that the file thus qualified is only to be assembled 
during the pass specified. The assembler makes two passes; n 
can be either 1 or 2. 


/LIBRARY 


Specifies that the file thus qualified is a macro library. The 
default file type is .MLB. A user macro library file must be 
specified in the command line before any source files that use 
the macros defined in the library. A library may not be the last 
file named in the command line. Remember that the system macro 
library has the type .SML. If you are referencing this library, 
you must explicitly state the type. 


Examples 


> MACRO 
File? NOODLE 


This example assembles the source file NOODLE.MAC into a 
relocatable object module named NOODLE.OBJ. 


“MACRO NOODLE 


This example is equivalent to the previous one. 


~MACRO NOODLE, DOODLEs YANKEE 


This example assembles the source files NOODLE.MAC, DOODLE.MAC, 
and YANKEE.MAC into a relocatable object module named YANKEE.OBJ. 


*MACRO/LIST NOOILE 


This example assembles the source file NOODLE.MAC into the object 
file NOODLE.OBJ, and also produces an assembly listing, 
NOODLE.LST. The assembly listing appears in your directory and 
is also printed on the line printer. 


PROGRAM DEVELOPMENT 
MACRO (Cont.) 


*MACRO/LISTI PRINCE NOODLE 
This example assembles the source file NOODLE.MAC into the object 
file NOODLE.OBJ, and also produces an assembly listing named 


PRINCE.LST. The assembly listing appears in your directory and 
is printed on the line printer. 


-MAC/LISTITIE NOODLE 
NOODLE MACRO M1113 2-SEF-82 11°41, PAGE 1 


*+TITLE NOODLE 
sLIST TTM . 
NLIST BEX 
+ MACRO LIBRARY CALLS 


+sMCALL EXITSS:OTONS DIRS 


MOF WS] O OF oD Po oe 


¢ 
+ 


+ 


This example assembles the source file NOODLE.MAC into the object 
file NOODLE.OBJ and types the assembiy listing on your terminai. 
No permanent copy of the listing file is retained, nor does’ the 
listing appear on the line printer. 


“MAC/OBJECTSROTINI NOODLE 


This example produces an object file with the name ROTINI.OBJ. 


“MACRO NOOULE/LIBRARY*:ROTINIsSPIRELLIT»SHELL 


This example assembles a concatenated object file named SHELL.OBJ 
from the source files NOODLE.MLB, ROTINI.MAC, SPIRELLI.MAC, and 
SHELL.MAC. 


“MACRO/NOSHOWSCOMMENTS/WIDE NOODLE 


This example produces an object module and an assembly listing. 
Any .LIST or .NLIST directives with TTM or COM as arguments are 
ignored. The directives themselves appear in the listing, but 
they have had no effect. The listing produced by this command 


includes no comments and is in wide format. The listing is 
printed on the line printer and appears in your directory as 
NOODLE.LST. 


Notes 
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This example produces an object module and an assembly listing. 
Any .LIST or .NLIST directives with COM, BIN, or ME arguments are 
ignored. The listing includes no comments and no binary code, 
but does include macro expansions. Observe the use of 
parentheses where two arguments are given for /NOSHOW and the 
lack of parentheses where only one argument is given for /SHOW. 


You must be familiar with MACRO-11 Assembly Language to use the 
MACRO command successfully. In particular, see the chapter on 
operating procedures in the PDP-1l MACRO-11 Language Reference 
Manual. See also the chapter on assembler directives for 
information on the /[NO]SHOW and /ENABLE and /DISABLE qualifiers. 


6.2.2 BASIC 


BASIC invokes an interpreter or compiler for the BASIC language. 
BASIC stands for Beginners All-Purpose Symbolic Instruction Code. 


Format 


BASIC[/qualifier] [@filespec]} 
Command Qualifiers 
/B1l 


/BP2 
/USING:userbasic 


Parameter 


@filespec 


Specifies an indirect command file that contains BASIC-PLUS-2 
commands. 


Command Qualifiers 


/Bll 


Specifies the BASIC-11 interactive language interpreter. Under 
this interpreter, programs are not compiled or task built. The 
BASIC-11 interpreter is a task that interprets and executes 
BASIC-i1 instructions. 


BASIC-11 includes an immediate or "desk-calculator™ mode. If 
your system includes BASIC-11, you should look into it even if 
you do not plan to program in BASIC-11. See the examples. 
BASIC-11 is compatible with Dartmouth BASIC. 


The BYE command causes an exit from BASIC-1l. 
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/BP2 
Invokes the BASIC-PLUS~2 compiler, which is the default. The BP2 
compiler can create Task Builder Command and Overlay Descriptor 
Language (ODL) files and a listing file in addition to the object 
module file for the program it compiles. See Section 6.4 for 
information on how to use these files with the LINK command. 
The EXIT command or a CTRL/Z causes an exit from BASIC-PLUS-2. 
/USING:userbasic 
Invokes an installed interpreter or compiler different from 
either of the DIGITAL BASIC systems discussed here. See your 
system manager for further information. 
Examples 
>BASIC/B1il 
ITAS/RSX BASIC VO2-0O1 
REALTY 
BYE 


In this example, the user invoked the BASIC-PLUS-2 interpreter 
with the BASIC/B11 command READY is the BASIC-11 prompt. The 


meme an 


e 
Mwy wmAmnnn Zt os Fan Tm _ T71 
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*BASIC 
FOF-11 BASIC-FLUS-2 V2.0 BL-00 
BASIC? 


EXIT 


In this example, the user invoked by default the BASIC-PLUS-2 
compiler. BASIC2 is the BASIC-PLUS-2 prompt. The EXIT command 
causes an exit from BASIC-PLUS~2 (as does CTRL/Z). 


*BASIC/B1i1 
IAS/RSX BASIC VO2-01 


READY 
PRINT CLO¢2) KC SER9) RC PISS) 
4297.7 


READY 

10 FOR [=i TO 10 
20 PRINT (CIXPID/3 
30 NEXT I 


READY 
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RUN 
NON AME eorUCieie Ife Ll iss 


1.9472 

240944 

3.14159 
4,1887° 
Sosa? 
&.2831% 
74350358 
S487 7as 
9.42478 
10.472 


READY 
BYE 


In this example, the user used the immediate mode of BASIC-11 
(without line numbers) to perform a calculation. Then, the user 
typed in a small program (with line numbers) to produce a_ table. 
This program can be saved; the immediate mode example cannot. 
BASIC-11 includes many mathematical functions and others can be 
defined. 


Notes 


See the BASIC documentation, if any, supplied with your system. 
Not all systems include BASIC. 


6.2.3 FORTRAN 
FORTRAN invokes a FORTRAN compiler. 


RSX-11M/M-PLUS systems may use two DIGITAL FORTRAN source language 
compilers: FORTRAN IV/IAS-RSX (commonly called FORTRAN IV), and 
FORTRAN-77. FORTRAN IV-PLUS is described in this section for those 
users who still have this compiler on their systems; however, 
FORTRAN-77 is superseding the FORTRAN IV-PLUS compiler. Since these 
compilers are optional software, your installation may have no FORTRAN 
compiler at all. 


Format 
FORTRAN[/qualifier[s]] filespec[,;s] 
Command Qualifiers 


/ {NO] CHECK 
/CODE:arg 
EAE 
EIS 
FIS 
THREADED 
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/CONTINUATIONS:n 
/ [NO] DLINES 
/{NO] EXTEND SOURCE 
/EOR 
/ FAP 
/{NO]F77 
/ IDENTIFICATION 
/{NOJ]14 
/{NO]LINE NUMBERS 
/{NO]LIST[:filespec] 
/{NO]MACHINE CODE 
/ {NO] MAP 
/{NOJOBJECT[:filespec] 
/ [NO] SHAREABLE 
/ SOURCE 
/ [NO] STANDARD: arg 
ALL 
NONE 
SOURCE 
SYNTAX 
/ [NO] TRACEBACK: arg 
ALL 
BLOCKS 
LINES 
NAMES 
NONE 
/USING:usercompiler 
/ {NO} VECTORS 
/ {NOT WARNINGS 
/WORK_FILES:n 


Parameter 
filespec[,s] 


Specifies the file or files to be compiled. If you name more 
than one file, separate the filespecs with commas. 


Files input to any of the FORTRAN compilers must contain FORTRAN 
source language to match that compiler. In other words, the 
FORTRAN IV compiler works only on FORTRAN IV source code, and so 
forth. See the FORTRAN documentation supplied with your system 
for more information. 


The default file type for all FORTRAN compilers is .FTN. 


NOTE 


The FORTRAN compilers use the name of the first file 
named in the command as the default name for output 
files. Except for MACRO-1l, all language commands and 
the LINK command use the first file named in the command 
as the default name for output files. 
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Command Qualifiers 
/FOR 


Specifies the FORTRAN IV compiler. This is the default for 


FORTRAN command, so it is not necessary to use this qualifier. 


the 


Your system must include the FORTRAN IV Object Module Library 
(OLB) and Object Time System (OTS) for this qualifier to work. 
Therefore, your system or library UFD must include the following 


files: 


FOROTS. OLB 
FOR.TSK 


/F4P 


- 


Specifies the FORTRAN IV-PLUS compiler. The system 
the FORTRAN IV-PLUS Object Module Library (OLB) 


My mlasAlea 
ust inci.uae 


and Object Time 


System (OTS) for this qualifier to work. Therefore, your system 


or library UFD must include the following files: 


F4POTS.OLB 
F4P.TSK 


Please note that FORTRAN IV-PLUS has been superseded 
FORTRAN-77. 


/{NOJ]F77 


Specifies the FORTRAN-77 compiler. /NOF77 is the equivalent 
/FAP. 


/ [NO] CHECK 


The /CHECK qualifier specifies that you wish the compiler 
check that all array references are within bounds. 


The default is /NOCHECK. 
This qualifier is for FORTRAN IV-PLUS and FORTRAN-77. 


/CODE:arg 
EAE 
EIS 
FIS 
THREADED 


by 


of 


to 


The /CODE qualifier specifies that the code has certain 
characteristics. EAE means the code uses the Extended Arithmetic 
Element. EIS means that the code uses the Extended Instruction 


Set. FIS means the code uses the Floating Instruction Set; 
also includes EIS. THREADED means the code is threaded. 


The /CODE qualifier is for FORTRAN IV only. 


FIS 
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/CONTINUATIONS:n 


The /CONTINUATIONS qualifier 


specifies 


maximum number of 
The value of n can be 


the 


continuation lines permitted in the code. 
from 0 through 99. The default is 5. 


The /CONTINUATIONS qualifier is for FORTRAN IV-PLUS and 


FORTRAN-77. 


/ {NO]DLINES 


"D" character 
The default is /NODLINES, 
comment lines. Use this 


The /DLINES qualifier specifies that lines with a 
in column 1 are to be compiled. 
meaning these lines are treated as 
feature for debugging. 


The /DLINES qualifier is for FORTRAN IV-PLUS and FORTRAN-77. 


/{NOJEXTEND SOURCE 


The /EXTEND SOURCE qualifier specifies that you wish the compiler 
to accept more than 72 columns of source input for each line. 
The default is /NOEXTEND SOURCE, meaning the compiler reads only 
columns 1 through 72 and treats lines after that as comments. 


The /EXTEND SOURCE qualifier is for FORTRAN IV only. 


/ IDENTIFICATION 
The /IDENTIFICATION qualifier causes the compiler to print its 
identification and version number on your terminal. 

/{(NOJI4 
The /14 qualifier causes a two-word default allocation for 
integer variables. The default is /NOI4, meaning the compiler 
causes a Single-word allocation for any integer variables not 
given an explicit length specification. 

/[NO]LINE NUMBERS 
The /LINE NUMBERS qualifier specifies that you wish the compiler 


to include Internal Sequence Numbers. Although these numbers 
create more object code and increase program execution time, they 
inform you which line caused your program to err, should it err. 
The default is /NOLINE NUMBERS. 


The /LINE NUMBERS qualifier is for FORTRAN IV only. 


/{NO]LIST[:filespec] 


Specifies whether a compiler listing should be generated. The 


default is /NOLIST, meaning no compiler listing is generated. 


If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the first source 
file in the FORTRAN command with the file type .LST. If you wish 


the listing to have a different name, supply the name as an 
argument to the /LIST gualifier. If un do supply a mame, the 
listing file appears in your directory but is not printed on the 


line printer. 


PROGRAM DEVELOPMENT 
FORTRAN (Cont.) 


The /LIST gualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /LIST is used as a command qualifier, the listing 
file is placed in your directory and printed on the line printer. 
If /LIST is used as a filespec qualifier, the listing file 
appears in your directory but is not printed on the line printer. 
If /LIST is used as a filespec qualifier, the listing file takes 
the name of that file. 


The /MACHINE CODE, /MAP, and /SOURCE, qualifiers all affect the 
contents of the compiler listing file. 


/{NO]MACHINE CODE 


The /MACHINE CODE qualifier specifies that you wish the compiler 
listing to include binary machine code and diagnostics. The 
default is /NOMACHINE CODE. 


/MACHINE CODE implies /LIST. You do not need to include the 
/LIST qualifier unless you wish to use it to establish a name for 
the listing file different from any of the file names included in 
the compilation. 


The /MACHINE CODE qualifier behaves in a different manner 
depending on whether it is given as a command qualifier or a 
filespec qualifier. If /MACHINE CODE is used as ae command 
qualifier, the listing file is placed in your directory and 
printed on the line printer. If /MACHINE CODE is used as a 
filespec qualifier, the listing file appears in your directory 
but is not printed on the line printer. If /MACHINE CODE is used 
as a filespec qualifier, the listing file takes the name of that 
file, 


/ [NO] MAP 


The /MAP qualifier specifies that you wish the compiler listing 
to include a storage map and diagnostics. 


/MAP implies /LIST. You do not need to include the /LIST 
qualifier unless you wish to use it to establish a name for the 
listing file different from any of the file names included in the 
compilation. 


The /MAP qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /MAP is used as a command qualifier, the listing 
file is placed in your directory and printed on the line printer. 
If /MAP is used as a filespec qualifier, the listing file appears 
in your directory but is not printed on the line printer. If 
/MAP is used as a filespec qualifier, the listing file takes the 
name of that file. 


/(NO] OBJECT[:filespec] 


Determines whether or not an object module is generated by the 
compiler. The default is /OBJECT, which does create a module. 
The default name of the object file created by FORTRAN is’ the 
mame of the last-named source file with the file type .OBU. If 
you wish the object file to have a different name, supply the 
name as an argument to the /OBJECT qualifier. 
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/NOOBJECT specifies that no object module is’ created. You can 
use the /NOOBJECT qualifier to get a compiler listing file to 
check for errors without generating object code. 


/SOURCE 
The /SOURCE qualifier specifies that you wish the compiler 
listing to include the source code. 


/SOURCE implies /LIST. You do not need to include the /LIST 
qualifier unless you wish to use it to establish a name for the 
listing file different from any of the file names included in the 
compilation. 


The /SOURCE qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /SOURCE is used as a command qualifier, the 
listing file is placed in your directory and printed on the line 
printer. If /SOURCE is used as a filespec qualifier, the listing 
file appears in youre directory but is not printed on the line 
printer. If /SOURCE is used as a filespec qualifier, the listing 
file takes the name of that file. 


/(NO] STANDARD: arg 
ALL 
NONE 
SOURCE 
SYNTAX 


The /STANDARD qualifier directs the compiler to look in = your 
source code for extensions to ANSI standard (X3.9-1978) FORTRAN 
at the full-language level. If the compiler finds extensions, it 
flags them and produces informational diagnostics. 

Although PDP-11 FORTRAN-77 conforms to the ANSI FORTRAN’ standard 
at the subset level, the compiler flags only those features that 
are extensions to the full language. See Appendix G of the 
PDP-11 FORTRAN-77 User's Guide for a list of flagged extensions. 


The ALL argument produces informational diagnostics for all 
detected extensions. 


The NONE argument produces no informational diagnostics. 


The SOURCE argument produces informational diagnostics for 
lowercase letters and tab characters in the source code. 


The SYNTAX argument is the same as /STANDARD with no argument. 
The default is /NOSTANDARD. 


The /[NO]STANDARD qualifier is for FORTRAN-77 only. 
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/ [NOj TRACEBACK:arg 
ALL 
BLOCKS 
LINES 
NAMES 
NONE 


/TRACEBACK controls the amount of extra code included in the 
compiled output for use by the OTS during error traceback. This 


code is used in producing diagnostic information and in 
identifying which statement in the FORTRAN source program caused 
an error condition to be detected during execution. This 


qualifier is for FORTRAN IV-PLUS and FORTRAN-77. 

The ALL argument states that error traceback information is to be 
compiled for all source statements, and function and subroutine 
entries, 

The LINES argument is the same as ALL. 

The BLOCKS argument states that traceback information is to be 
compiled for subroutine and function entries and initial 
statements in sequences called blocks. This is the default. 


The NAMES argument states that traceback information is to be 
compiled only for subroutine and function entries. 


The NONE argument states that no traceback information is to be 
produced. 


/USING:usercompiler 


Invokes a FORTRAN compiler other than one of the DIGITAL-supplied 
compilers. 


/ [NO] VECTORS 
The /VECTORS qualifier specifies that you wish vectored arrays. 
This increases the size of object modules but decreases execution 
time. The default is /VECTORS. 
The /VECTORS qualifier is for FORTRAN IV only. 

/ [NO] WARNINGS 


The /WARNINGS qualifier specifies that you wish the compiler to 
issue warning diagnostics. This is the default. 


The /WARNINGS qualifier is for FORTRAN IV only. 
/WORK_FILES:n 


The /WORK FILES qualifier specifies the number of temporary 
on-disk files you wish used during the compilation. n can be 
from 0 through 3; the default is 2. Increasing the number of 
work files increases the maximum possible size of your program 
but decreases the speed of compilation. 
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Examples 


= FORTRAN 
File(sd? Cony 


This example compiles the FORTRAN IV source file CODY.FTN into 
the relocatable object module CODY.OBJ. 


>FORTRAN/F 77 
File(s)? corny 


This example compiles the FORTRAN-77 source file CODY.FTN into 
the relocatable object module CODY.OBJ. 


“FOR SAK: COLYsGERARD 


The FORTRAN IV compiler compiles the source files SAX.FTN, 
CODY.FTN, and GERARD.FTN into a relocatable object module named 
SAX.OBJ. The commas (,) cause the three source files to be 
concatenated. 


“FOR/LIST Cony 


This example creates an object module, CODY.OBJ, and a compiler 
listing, CODY.LST, from a source file, CODY.FTN. The listing 
file and object module appear in your UFD and the listing fiie is 
printed on the line printer. 


“FOR/LISTICONY GERARD 


This example creates the object module GERARD.OBJ and a compiler 
listing, CODY.LST, from the source file, GERARD.FTN. Both output 
files appear in your UFD, but the listing file is not printed on 
the line printer. To print this file, issue a PRINT command. 


~FOR/LISTITI:3 CASSARY 
This example creates the file CASSADY.OBJ and prints the assembly 
listing on your terminal. No listing file is printed on the line 
printer or retained in your directory. 

~FOR/F77/OBJICASSADNY STELLA 
The FORTRAN-77 compiler creates an object module, CASSADY.OBJ, 
from the source file STELLA.FTN. 

“~FORTRAN/LIST CODY sLOWELL 
This command creates the object module CODY.OBJ and the listing 


file CODY.LST using the files CODY.FTN and LOWELL.FTN as input. 
CODY.LST is printed on the line printer. See the next example. 
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=FORTRAN CODYsLOWELL/LIST 


This command creates the object module CODY.OBJ and the listing 
file LOWELL.LST using the files CODY.FTN and LOWELL.FTN as input. 
LOWELL.LST is not printed on the line printer. 


=> FORTRAN DHARMA:MEXICO/ MAP 


This command creates the object module DHARMA.OBJ and the listing 
file MEXICO.LST using the file DHARMA.FTN and MEXICO.FTN as 
input. The listing file includes a storage map and diagnostics. 
The listing file is not printed on the line printer. 


Notes 


It is not uncommon for installations to have more than one 
FORTRAN compiler availabie. Since the default file type is the 
same for all DIGITAL FORTRAN compilers, you will have to use some 
care in differentiating source files for the different compilers. 


See the FORTRAN documentation supplied with your system. 


6.2.4 COBOL 


COBCL is a language widely used for business applications. 
RSX-LIM/M-PLUS systems support both COBOL-81 and PDP-11l COBOL. Since 
these products are optional software, your system may include one, 
both, or neither of these compilers. 


Both the COBOL-81 and PDP-11 COBOL compilers convert source files 
written in the COBOL language to relocatable object modules. The Task 
Builder uses these modules to produce task-image files that can be run 
on your system (see Section 6.4). 


The next two sections discuss how to invoke each COBOL compiler. For 
COBOL-81, use the COBOL command (see Section 6.2.4.1). For PDP-1l 
COBOL, use the COBOL/C11 command (see Section 6.2.4.3). Section 
6.2.4.2 gives examples for the COBOL-81 compiler. Section 6.2.4.4 
gives examples for the COBOL/C1l compiler. 


This section discusses the command line format and compile-time 
qualifiers for COBOL-81. Normal defaults for qualifiers are 
indicated. However, these defaults will not apply to your system if 
your system manager changed the default settings when installing the 
compiler. 


If you are using a compiler that has not been supplied by DIGITAL, 
specify the COBOL command with the /USING qualifier. The format is: 


COBOL/USING:usercompiler 
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Format 
COBOL[/qualifier[s]] filespec 
Command Qualifiers 


/ [NO] ANSI_FORMAT 
/(NO]CHECK:arg 

[NO] BOUNDS 

[NO] PERFORM 

ALL 

NONE 
/CODE: [NOJCIS 
/[NO]CROSS REFERENCE 
/{NO]DEBUG — 
/{NO]DIAGNOSTICS[:filespec] 
/(NOJ]LIST[:filespec] 
/NAMES: xx 
/ [NO] OBJECT[(:filespec] 
/{NO]OVERLAY DESCRIPTION 
/ [NO] SHOW: [NO] MAP 
/({NO] SKELETON 
/ [NO] SUBPROGRAM 
/ TEMPORARY :device 
/ [NO] TRUNCATE 
/USING: usercompiler 
/ {NO]WARNINGS: [NO] INFORMATIONAL 


Parameter 

filespec 
Specifies the source file to be input to the COBOL-81 compiler. 
File input to the COBOL-81 compiler must contain COBOL source 
code. File specifications must have file names. The default 
file type is .CBL. 

Command Qualifiers 

/{NO] ANSI_ FORMAT 
The /ANSI_ FORMAT qualifier specifies that the source file is in 
conventional (or ANST) format. Conventional format has 
80-character lines with Area A beginning in character position 8. 
The /NOANSI_ FORMAT qualifier specifies that the source file is in 
terminal format, a DIGITAL-specified format that permits variable 


length lines with Area A beginning in character position l. 


The default is /NOANSI FORMAT. 
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/{(NO] CHECK: arg 
{NO] BOUNDS 
[NO] PERFORM 
ALL 
NONE 


The /CHECK and /CHECK:ALL qualifiers are equivalent -- both to 
each other, and also to /CHECK:BOUNDS and /CHECK: PERFORM in 
combination. They add object code that checks the ranges of 
subscripts, indexes, and nested perform statements at run time. 


The /CHECK:BOUNDS qualifier compares subscript and index ranges 
at run time against the ranges defined by corresponding OCCURS 
clauses. If any range is exceeded during program execution, 
COBOL-81 issues an error message. 


The /CHECK: PERFORM qualifier determines whether or not your 
program's PERFORM statements are nested properly (if nested at 
all). If COBOL-81 detects improper nesting during program 
execution, it issues an error message. 


The /NOCHECK and /CHECK:NONE qualifiers are equivalent -- both to 
each other, and also to /CHECK:NOBOUNDS and /CHECK:NOPERFORM in 
combination. They suppress all range checking. 


The /CHECK:NOBOUNDS qualifier suppresses range checking only for 
subscripts and indexes. 


The /CHECK:NOPERFORM qualifier suppresses range checking only for 
nested PERFORM statements. 


The qualifiers that Suppress range checking reduce task size and 
improve program performance. 


The default is /CHECK (/CHECK:ALL). 
/CODE: [NO]CIS 


The /CODE:CIS qualifier tells the compiler to use CIS (Commercial 
Instruction Set) in the object code it produces. 


The /CODE:NOCIS qualifier tells the compiler not to use CIS. 


These qualifiers override the default for your system. They are 
used to develop programs that will execute on a different system 
than the one used for program development. For example, if your 
system has CIS, you use /CODE:NOCIS to compile a program that 
will run on a system without CIS. 


If your system has the Commercial Instruction Set installed, the 
default is /CODE:CIS. Otherwise, the default is /CODE:NOCIS. 
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/{NOJCROSS REFERENCE 


The /CROSS REFERENCE qualifier causes the compiler to produce a 
list file and to add two cross-reference tables to the end of the 
list file: one for data-names and one for procedure-names. In 
each table, the names you use in your COBOL program are listed 
alphabetically. Opposite each name is a list of every line 
number in which that name occurs. A "D" after a number indicates 
the line in which you define the name. An asterisk (*) after a 
line number indicates a destructive reference, such as a value 
assignment to a data-name. 


The /NOCROSS REFERENCE qualifier suppresses production of the 
cross-reference tables. 


The default is /NOCROSS REFERENCE. 

/ {NO] DEBUG 
The /DEBUG qualifier indicates that you plan to include the 
COBOL-81 Symbolic Debugger in your task image. To support the 
Symbolic Debugger, the compiler generates symbol information in 
the object module for all data-names and procedure-names in your 


program. 


If you include the Symbolic Debugger in your program, you must 
also use the /DEBUG qualifier to the LINK/C81 command (see 
Section 6.4.3). 


The /NODEBUG qualifier suppresses generation of symbol 
information in the object module. 


The default is /NODEBUG. 

/(NO]DIAGNOSTICS[:filespec] 
The /DIAGNOSTICS qualifier creates a diagnostics file that 
contains the compiler diagnostic summary. If you do not append a 
file specification, the diagnostics file has the same file name 


as your source file, and the file type .DIA. 


The /NODIAGNOSTICS qualifier suppresses the creation of a 
diagnostics file. 


The default is /NODIAGNOSTICS. 

/{NO]LIST[:filespec] 
The /LIST qualifier produces a list file which contains both the 
complete source code and any diagnostic messages. If you do not 
append a file specification, the list file has the same file name 
as the source file and has the file type .LST. 


The /NOLIST qualifier suppresses the production of a list file. 


The default is /NOLIST. 
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/NAMES: xx 


The /NAMES:xx qualifier tells the compiler to use the two 
alphanumeric characters you specify as the PSECT kernel for your 
program. You use this qualifier to ensure unique identification 
for PSECT kernels when your task image uses both subprograms and 
segmentation. 


/{NO] OBJECT[:filespec] 


The /OBJECT qualifier produces an object module. If you do not 
append a file specification to the qualifier, the object module 
has the same file name as the source, and the file type .OBJ. 


The /NOOBJECT qualifier suppresses production of an object module 
and its associated skeleton ODL file. (See the description of 
/ [NO] SKELETON.) 


The default is /OBJECT. 
/{NO] OVERLAY DESCRIPTION 


The /OVERLAY DESCRIPTION qualifier produces two files -- an 
indirect command file and an Overlay Descriptor Language file. 


The indirect command file has the same file name as the source 
and the file type .CMD. It can be input to the Task Builder to 
create the task image. 


The Overlay Descriptor Language file has the same file name as 
the source and the file type .ODL. It contains pointers to 
certain support routines that must be included in your task image 
(for example, system support for file input/output). 


If you plan to use the LINK/C81 command to task-build your 
program, do not use the /OVERLAY DESCRIPTION qualifier. LINK/C81 
also creates a .CMD and an .ODL file, and cannot reference the 
-CMD and .ODL files created during program compilation. 


The /NOOVERLAY DESCRIPTION qualifier suppresses production of 
-CMD and .ODL files during program compilation. 


The default is /NOOVERLAY DESCRIPTION. 
/ {NO] SHOW: [NO] MAP 


The /SHOW and /SHOW:MAP qualifiers are equivalent. They cause 
the compiler to produce a list file and to append two offset maps 
to the list file. One offset map refers to the Data Division and 
one to the Procedure Division. The compiler provides these maps 
for use with ODT (the On-Line Debugging Tool). Consult the 
IAS/RSX-11 ODT Reference Manual for more information. 


The /NOSHOW and /SHOW:NOMAP qualifiers are equivalent. They 
suppress production of the offset maps. 


The default is /NOSHOW (/SHOW:NOMAP). 
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/{NO] SKELETON 


The /SKELETON qualifier produces a skeleton ODL file, which 
specifies the overlay structure for the object module. This file 
has the same file name as the source and the file type .SKL. 


You cannot use the /SKELETON qualifier to override the /NOOBJECT 
qualifier. That is, an .SKL file cannot be produced when the 
-OBJ file is suppressed. 


The /NOSKELETON qualifier suppresses production of the .SKL file. 


You cannot use the /NOSKELETON qualifier if you plan to 
task-build your program with the LINK/C81 command (see Section 
64403) % LINK/C81 assumes the presence of the  .SKL file. 
Although the .SKL file is not strictly necessary for all 
programs, DIGITAL does not recommend that you suppress its 
production unless you are familiar with task-building 
alternatives to LINK/C81. 


The default is /SKELETON. 
/ [NO] SUBPROGRAM 


The /SUBPROGRAM qualifier tells the compiler to treat the source 
file as a subprogram. You should use this qualifier only if the 
subprogram does not use parameters from the main program; that 
is, if it does not contain the Procedure Division USING header. 


The /NOSUBPROGRAM qualifier tells the compiler to treat the 
source aS a main program. 


The default is /NOSUBPROGRAM. 
/ TEMPORARY :device 


The /TEMPORARY qualifier tells the compiler to store the 
temporary work files it uses during program compilation on the 
device you specify. Since the default device is the system disk 
(SY¥:), this qualifier is useful if there is little system disk 
space available. 


/ {NO] TRUNCATE 


The /TRUNCATE qualifier tells the compiler to perform decimal 
truncation on the values of COMP data items. With decimal 
truncation, the maximum value the data item can contain depends 
on the item's PICTURE character-string. 


The /NOTRUNCATE qualifier tells the compiler to perform binary 
truncation on the values of COMP data items. With binary 
truncation, the maximum value a COMP item can contain depends on 
its storage allocation. 


The default is /NOTRUNCATE, 
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/ [NO]WARNINGS: [NO] INFORMATIONAL 


The /WARNINGS and /WARNINGS: INFORMATIONAL qualifiers are 
equivalent. They cause the compiler to issue informational, 
warning, and fatal diagnostics. 


The /NOWARNINGS and /WARNINGS:NOINFORMATIONAL qualifiers are 
equivalent. They suppress production of informational, warning, 
and fatal diagnostics. 


The default is /WARNINGS (/WARNINGS: INFORMATIONAL). 


6.2.4.2 COBOL-81 EXAMPLES 
COBOL 
Filets)? DULUOZ 


This example compiles the COBOL-81 source file DULUOZ.CBL into’ the 
relocatable object module DULUOZ.OBJ. 


sCOBOL/LIST?TI: SAX 
This example creates the object file SAX.OBJ from the COBOL-81 source 
file SAX.CBL and prints the compiler listing on your terminal. No 
listing file is printed on the line printer or retained in your 


current UFD. 


For more detailed information on compiling your COBOL-81 source 
program, refer to the COBOL-81 RSX-11M/M-PLUS User's Guide. 


6.2.4.3 PDP-11 COBOL 
This section discusses the command line format and compile-time 
qualifiers for PDP-11l COBOL plus gives you the MCR equivalents to the 
DCL qualifiers. The defaults for the qualifiers are included in the 
qualifier descriptions. You can override these defaults only in the 
PDP-11 COBOL compiler command line. 
Format 

COBOL/C11[/qualifier[{s]] filespec 


Command Qualifiers 


DCL Mode MCR Mode Equivalent 
/ANSI_ FORMAT /CVE 

/NOANSIFORMAT 

/ CHECK 

/NOCHECK /-BOU 

/CM6 /CM6 

/NOCM6 


COBOL/C11 (Cont.) 
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/CROSSREFERENCE /CREF 
/NOCROSSREFERENCE (default listing) 
/GARGESYMBOLTABLE:n /SYM:n 


/LIST[:filespec] 
/NOLIST 


(default listing) 


/ NAMES: xx /KER: XX 

/NESTin /PFM:n 
/OBJECT[:filespec] 

/NOOBJECT ,=T 

/OVERLAY /OV 

/NOOVERLAY 

/POOLLITERALS 

/NOPOOLLITERALS /~-PLT 

/ READONLY /RO 

/NOREADONLY 

/SHOW:COPYLIST (default listing) 
/NOSHOW: COPYLIST /NL 

/ SHOW: MAP /MAP 

/NOSHOW: MAD (default listing) 


/ SHOW: VERBLOCATION /OBI 
/NOSHOW: VERBLOCATION (default listing) 
/ SKELETON 
/NOSKELETON /-SKL 
/SUBPROGRAM /SUB 
/NOSUB PROGRAM 
/TEMP:dev /TMP:dv 
/WARNINGS /ERR:1 
/NOWARNINGS /ERR: 2 
Parameter 
filespec 


Specifies a source file to be input to the PDP-11 COBOL compiler. 


File input to the PDP-11 COBOL compiler must contain COBOL source 


code. File specifications 


file type is .CBL. 


must have file names. 


The default 


Command Qualifiers 
/{NO] ANSI_FORMAT 
The /ANSI_ FORMAT qualifier specifies that the source file is in 


conventional format: 80-character lines with Area A beginning in 
character position 8. The default is /NOANSI FORMAT. 
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The /CHECK qualifier specifies that the code generated will check 
that subscripts and indexes are in their legal bounds when they 
are used. 


The /NOCHECK qualifier suppresses this checking, which increases 
execution speed for programs with a large number of subscripted 
or indexed references. The default is /CHECK. 


/ [NO] CM6 


The /CM6 qualifier specifies that you wish the compiler to change 
all COMPUTATIONAL references to COMPUTATIONAL-6. The default is 
/NOCM6. 


/{NO]CROSS REFERENCE 


The /CROSS REFERENCE qualifier specifies that you wish a 
cross-reference listing to be included as part of the listing 
file. 


/CROSS REFERENCE implies /LIST. You do not need to include the 
/LIST qualifier unless you wish to use it to establish a name for 
the listing file different from the source file. 


The /CROSS REFERENCE qualifier leaves the listing file in your 
current directory. 


/LARGE_ SYMBOL TABLE[:n] 


The /LARGE SYMBOL TABLE qualifier specifies that you wish the 
compiler to obtain more symbol-table space, where n is a number 
from 1 through 4. The default is 1. Here are the results of 
using this qualifier: 


Maximum Maximum 
n Data Names Procedure Names 
(approximate) (approximate) 
1 761 761 
2 1021 1021 
3 1531 1531 
4 2039 2039 
/(NO]LIST[:filespec] 
Specifies whether a compiler listing should be generated. The 


default is /NOLIST, meaning no compiler listing is generated. 


If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the source file, 
with the file type .LST. If you wish the listing to have a 
different name, supply the name as an argument to the /LIST 
qualifier. 


If your command line includes the /CROSS REFERENCE qualifier, 
/LIST is implied and need not be specified. 


If your command line includes listing-control arguments to either 
/SHOW or /NOSHOW, /LIST is implied and need not be specified. 
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The only time you need to use /LIST with /CROSS REFERENCE or 
/{NO]SHOW is when you wish to give the listing file a filespec 
other than the default. The listing file appears in your 
directory. 


/NAMES: xx 


The /NAMES qualifier specifies that you wish the compiler to 
generate program section names that use the 2-character kernel, 
xx, to make them unique for this compilation. xx is a 
2-character text string that may include the numerals 0 through 9 
and the letters A through Z. 


/NESTin 


The /NEST qualifier allows you to specify the maximum number of 
nested PERFORM statements in the program. The compiler generates 
a nested PERFORM stack equal in depth to the decimal number on. 
The default is 10. 


/ {NO]OBJECT[:filespec] 


The /NOOBJECT qualifier specifies that you do not wish to create 
an object file. Use this qualifier if you wish only to check for 
errors or generate a listing. 


/OBJECT is the default and specifies that you wish to create an 
object file. The optional filespec argument enables you to give 
the object file a name different from that of the source file. 


/ [NO] OVERLAY 


The /OVERLAY qualifier specifies that you wish the compiler to 
make all procedural program sections overlayable. This is done 
by keeping procedural statements out of the root section. 


/NOOVERLAY is the default. 
/{NO] POOL LITERALS 


The /POOL LITERALS qualifier specifies that you wish the compiler 
to pool literals automatically to minimize the memory required to 
store them. This is the default. Since pooling literals slows 
down the speed of the compilation, you can specify 
/NOPOOL LITERALS to speed it up. 


/{NO]READ ONLY 


The /READ ONLY qualifier specifies that you wish the compiler to 
generate a read-only program section for the procedure division 
object module. The default is /NOREAD ONLY, which means’ these 
object modules are read/write. = 


/ [NO] SHOW: (arg[,Ss]) 
COPY LIST 
MA 


VERB LOCATION 


The /SHOW and /NOSHOW qualifiers specify elements you wish 
included in or excluded from the listing file. If you specify 
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only a single argument, the parentheses are not needed. Your 
command line can include both /SHOW and /NOSHOW. 


/SHOW implies /LIST, but if you wish the listing file to have a 
name other than the default, you must still use /LIST. 


The qualifier /NOSHOW:COPY LIST specifies that you do not wish 
the listing file to include source statements copied from a 
library file. The resulting listing includes only the COPY 
statement. The default is /SHOW:COPY LIST. 


The /SHOW:MAP qualifier specifies that you wish the listing to 
include any external subprograms that were referenced plus the 
following special maps: 


e Data Division 
e Procedure Division 
@e Data and Control Program Sections 
e OTS Routine References 
e Segmentation 
The default is /NOSHOW:MAP, 


The /SHOW: VERB LOCATION qualifier specifies that you wish the 
listing file to include the object location of the code for each 
program verb. The information is listed on the line preceding 
the source statement it describes. The default is 
/NOSHOW: VERB_ LOCATION. 


/ [NO] SKELETON 


The /SKELETON qualifier specifies that you wish the compiler to 
create a skeleton Overlay Description Language (.SKL) file. This 
is the default operation. The file is named after the file named 
in the COBOL/C11 command, with the file type .SKL. If you do not 
wish the .SKL file created, specify /NOSKELETON. 


/ [NO] SUBPROGRAM 


The /SUBPROGRAM qualifier tells the compiler to treat the source 
file as a subprogram. You should use this qualifier only if the 
subprogram does not use parameters from the main program; that 
is, if it does not contain the Procedure Division USING header. 


The /NOSUBPROGRAM is the default and means the compiler will 
treat the source as a main program. 


/TEMP:dev 


The /TEMP qualifier tells the compiler to store the temporary 
work files it uses during program compilation on the device you 
specify. Since the default is the system disk (SY), this 
qualifier is useful if there is little system disk space 
available. Do not specify a colon (:) as a delimiter after dev. 
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/WARNINGS 


The /WARNINGS qualifier specifies that you wish both warning and 
fatal diagnostics printed in the listing. See /NOWARNINGS. 


The default, without either /WARNING or /NOWARNING specified, is 
to print informational, warning, and fatal diagnostics. 


/NOWARNINGS 


The /NOWARNINGS qualifier specifies that you wish only fatal 
diagnostics printed in the listing. See /WARNINGS. 


Notes 


See the PDP-11 COBOL documentation supplied with your system for 
further information. 


6.2.4.4 COBOL/C11 Examples 


“COBOL/C11 LEDUX 


This example compiles the COBOL/C11 source file LEDUX.CBL into’ the 
relocatable object module LEDUX.OBJ. 


~COBOL/C1i“/LIST MARDOU 


This example creates an object module, MARDOU.OBJ, and a COBOL-11 
compiler listing, MARDOU.LST, both of which appear in your current 
UFD. 


~COBOL/CLII/LISTIMARDOU LEDUX 


This example creates the object module LEDUX.OBJ and a compiler 
Listing, MARDOU.LST, from tne COBOL-11 source file LEDUX.CBL. Both of 
the output files appear in your current UFD. 


~COBOL/CLI/LISTIGALLOWAY/SHOW: MAP 


This example creates an object module called GALLOWAY.OBJ and a 
listing file called GALLOWAY.LST. The listing file includes the 
special map with the data divisions, procedure map, segmentation map, 
program sections, and so forth, as described under the /SHOW 
qualifier. 


6.2.5 CORAL 66 


RSX-11M/M-PLUS systems support CORAL 66, a high-level biock-structured 
programming language. CORAL stands for Computer On-Line Real-Time 
Applications Language. 
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CORAL 66 is the standard general-purpose language prescribed by the 
British Government for real-time and process-control applications. It 
is defined in BS 5905, British Standard Specification for Computer 
Programming Language CORAL 66. 


CORAL 66 is designed to replace assembly-level programming in modern 
industrial and commercial applications. It is used for long-life 
products where ease of maintenance and flexibility are required. 
Because this compiler is optional software, your system may not 
include it. 


Format 
CORAL[/qualifier[s]] filespec[,s] 
Command Qualifiers 


/ [NO] CHECK 
/CODE:arg 
EIS 
FIS 
FPP 
PIC 
(EIS, PIC) 
(FIS,PIC) 
(FPP, PIC) 
/{NO] EXTEND SOURCE 
/{NO]LIST[:filespec] 
/([NO] MACHINE CODE 
/NAMES: x ~ 
/ (NO]OBJECT[:filespec] 
/([NOJOPTIMIZE[:LEVEL:n] 
/READ_ONLY[:arg] 
ALL 
NONE 
PURE DATA 
/{NO]SHOW[: (arg[,s]) ] 
ALL 


EXPANSIONS 
NONE 
OVERRIDE 
SOURCE 
STATISTICS 
SYMBOLS 
/ [NO] STANDARD 
/TEST(:n] 
/ [NO] TRACEBACK 
/WIDTH:n 
Parameter 
filespec[,s] 
Specifies the file or files to be compiled. If you name more 


than one file, separate the filespecs with commas. 


Files input to the CORAL 66 compiler must contain CORAL 66 source 
code. The default file type is .COR. 
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Command Qualifiers 
/ {NO] CHECK 


The /CHECK qualifier specifies that the code generated will check 
that all subscripts used in array and switch references are 
within bounds. 


The default is /NOCHECK. 


/CODE?arg 


mra 


EIS 
FIS 
FPP 
PIC 


The /CODE qualifier allows you to choose (at compile time) the 
instruction set for which the code is to be generated regardless 
of which machine is used to compile the source program. 


EIS means that the code uses the Extended Instruction Set. The 
default is /CODE:EIS. 


FIS means that the code uses the Floating Instruction Set. 


FPP means that the code uses the Floating Point Processor. 


NOTE 


You cannot specify any combinations of EIS, FIS, and FPP 
codes. 


PIC means that the code is position-independent. With the 
qualifier set to /CODE:PIC, a SWITCH declaration in the CORAL 
source is compiled as a list of relative jumps in instruction 
space. 


If you specify /CODE:NOPIC (the normal default), a SWITCH 
declaration is compiled as a list of addresses in data space. 


If you want to GOTO a switch that has been declared in COMMON and 
any target switch label is in an overlaid segment of your task, 
you must use /CODE:PIC for the Autoload mechanism to work. 


As with other qualifiers, the supplied default, /CODE:NOPIC, may 
be changed when the CORAL 66 compiler is installed. 


You can combine EIS, FIS, and FPP codes with PIC as follows: 
/CODE: (EIS, PIC) 
/CODE: (FIS, PIC) 
/CODE: (FPP, PIC) 
/{NO] EXTEND SOURCE 


The /NOEXTEND SOURCE qualifier causes the compiler to process 


only the first 72 characters of source input per line. This is 


ee ee 
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used if your input is on punched cards and the cards contain 
sequencing information in columns 73 through 80. 


The default is /EXTEND SOURCE, meaning that all characters in an 
input line are processed. 


NOTE 


The compiler treats a TAB as a Single character. 


/{NOJLIST(:filespec] 


The /LIST qualifier allows you to specify whether a compiler 
listing should be generated. The default is /NOLIST, meaning no 
compiler listing is generated. 


If you do not supply a file specification for this qualifier, the 
listing has a file name derived from the name of the first source 
file in the CORAL command and the file type .LST. If you want 
the listing to have a different name, supply the name as an 
argument to the /LIST qualifier. If you do supply a name, the 
listing file appears in your directory but is not printed on the 
line printer. 


The /LIST qualifier behaves in a different manner depending on 
whether it is given as a command qualifier or a filespec 
qualifier. If /LIST is used as a command qualifier with no 
filespec, the listing file is placed in your directory and 
printed on the line printer. If /LIST is used as ae filespec 
qualifier, the listing file appears in your directory but is not 
printed on the line printer. If /LIST is used as a filespec 
qualifier, the listing file takes the name of that file. 


/[NO]MACHINE CODE 


The /MACHINE CODE qualifier specifies that you wish the compiler 
listing to include a representation of the machine code 
generated. The default is /NOMACHINE CODE. 


/MACHINE CODE produces a listing of the object code produced by 
the compiler, correlated with the source file and line number. 
The first octal number is the offset of the instruction in the 
current program section (segment). This is followed by an octal 
representation of the internal code format and the instruction in 
a format similar to MACRO-11. 


/MACHINE CODE implies /LIST. You do not need to use the /LIST 
qualifier unless you wish to specify a name for the listing file 
that is different from any of the names included in the 
compilation. 


The /MACHINE CODE qualifier behaves in a different manner 
depending on whether it is given as a command qualifier or a 
filespec qualifier. If /MACHINE CODE is used as a command 
qualifier, the listing file is placed in your directory and 
printed on the line printer. If /MACHINE CODE is used as a 
filespec qualifier, the listing file takes the name of that file. 
The listing file appears in your directory but is not printed on 
the line printer. 
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/ NAMES: x 


The /NAMES qualifier causes the first character of 
compiler-generated program-section names to be the character '‘'x' 
in order to make them unique for this compilation. If you do not 
specify /NAMES, compiler-generated program-section names start 
with the character 'S'. 


/{NO] OBJECT[:filespec] 


This qualifier allows you to specify whether or not the compiler 
must generate an object module. The default is /OBJECT, which 
creates an object module. The default name of the object file 
created by CORAL 66 is the name of the last-named source file and 
the file type .OBJ. If you wish the object file to have a 
different name, supply the name as an argument to the /OBJECT 
qualifier. 


/NOOBJECT specifies that no object module is created. You can 
use the /NOOBJECT qualifier to get a compiler listing file to 
check for errors without generating object code. 


/{NO] OPTIMIZE[:LEVEL:n] 


The /OPTIMIZE qualifier allows you to optimize the function of 
CORAL 66 source programs. The qualifier allows code generated by 
the compiler to be replaced, where possible, by more efficient 
code constructions. 


/NOOPTIMIZE or /OPTIMIZE:LEVEL:0 means no optimization occurs. 


/OPTIMIZE or /OPTIMIZE: LEVEL: 1 allows three optimization 
iterations. The default is /OPTIMIZE. 


/OPTIMIZE:LEVEL:2 allows as many iterations as necessary. 


/READ ONLY [:arg] 
; ALL 
‘NONE 

PURE DATA 


The /READ ONLY qualifier allows you to alter the READ-ONLY or 
READ-WRITE attributes of program sections. 


/READ ONLY:ALL creates pure data and instruction program sections 
with the READ-ONLY attribute and impure data program sections 
with the READ-WRITE attribute. 


/READ_ONLY:NONE creates all program sections with the READ-WRITE 
attribute. 


/READ ONLY:PURE DATA creates pure data program sections with the 
READ-ONLY attribute and all other program sections with the 
READ-WRITE attribute. The default is /READ_ ONLY: PURE DATA. 
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/{NO]SHOW[: (arg[,s])] 
AGL 
EXPANSIONS 
NONE 
OVERRIDE 
SOURCE 
STATISTICS 
SYMBOLS 


The /SHOW and /NOSHOW qualifiers specify elements you wish 
included in or excluded from the listing file. If you specify 
only a single argument, the parentheses are not needed. Your 
command line can include both /SHOW and /NOSHOW. 


/SHOW implies /LIST, but if you wish the listing file to have a 
name other than the default, you must still use /LIST. 


/SHOW aS a command qualifier causes the file to be printed on the 
line printer. /SHOW as a filespec qualifier prevents the listing 
file from being printed. The default is /SHOW. 


/SHOW: ALL is equivalent to: 
q 
/ SHOW: (EXPANSIONS, OVERRIDE, SOURCE, STATISTICS,SYMBOLS) 


The /SHOW: EXPANSIONS qualifier causes the compiler to produce a 
source listing with all macros expanded. Line numbers are not 
incremented during macro expansions, so if an error occurs, the 
line number printed will refer to the source line in which the 
macro was used. The default is /SHOW:NOEXPANSIONS. 


The /SHOW:NONE qualifier performs the same function as /NOSHOW. 


The /SHOW:OVERRIDE qualifier overrides /NOLIST in the source 
code. The default is /SHOW:NOOVERRIDE. 


The /SHOW:SOURCE qualifier causes the compiler to produce a 
source listing. The default width of the listed file is 132 
characters but may be changed to another width by using the 
/WIDTH qualifier. Each listed line of the source file is 
prefixed by the current file number and line number. When 
several files are compiled, the line numbers restart with each 
new file. The listing may be made more readable by, for example, 
including form feeds in the source at the start of each segment 
or large procedure. 


Each page is printed with a two-line header. The first line 
gives the following information: 


program name 

compiler name and version 

time and date at the start of compilation 
page number 


If a 'TITLE' statement has been processed, the text in that 
statement is printed on the second line. The 'TITLE' text may be 
up to 64 characters in length. 


The /SHOW:NOSOURCE qualifier means a source listing is not 
produced. The default is /SHOW:SOURCE, 
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The /SHOW:STATISTICS qualifier causes the compiler to produce 
Statistics displaying information on the internal working of the 
compiler. The /SHOW:NOSTATISTICS qualifier suppresses this 
function. 


The default is /SHOW:STATISTICS. 


The /SHOW:SYMBOLS qualifier causes the compiler to print out data 
and label maps, sorted by symbol names in alphabetical order. 
Where symbols declared in different contexts have identical 
names, these are further sorted into ascending file and line 
number order. 


The /SHOW:NOSYMBOLS qualifier means the compiler does not create 
a listing of the symbol table. The default is /SHOW:SYMBOLS. 


/ [NO] STANDARD 


The /STANDARD qualifier highlights non-IECCA keywords in the 
listing as warning messages. (IECCA is an acronym for the Inter 
Establishment Committee for Computer Applications, the body 
responsible for approving computer hardware and software for 
British military applications.) For example, the keyword 
‘INCLUDE' will generate a message of the following format: 


Error 213 in File 2 Line 10 Character 1 
Warning-Non-Standard Keyword 


The /NOSTANDARD qualifier suppresses this function. The default 
is /NOSTANDARD. 


/TEST[:n] 


The /TEST qualifier allows you to retain or omit declarations and 
statements from a particular compilation without editing the 
source text. This qualifier is used in conjunction with the 
'TEST' keyword. You may specify any declarations or statements 
in the source program as follows: 


‘TEST’ (x) 'INTEGER' VAR; 

where x is any positive integer. 

If you specify the /TEST[:n] qualifier, the compiler will process 
all 'TEST' (x) statements where x is less than or equal to n. 
Therefore, to ignore all 'TEST' statements, set /TEST:0 or omit 
the qualifier at compile time. The default is /TEST:0. 

/ [NO] TRACEBACK 

The /TRACEBACK qualifier generates additional code to print 
source-file and line-number information in run-time error 


messages. 


/NOTRACEBACK suppresses this function and is the default. 
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The /WIDTH:n qualifier allows you to set the listing file to a 
specific width in the decimal range 8 through 132. 


The default width is /WIDTH:132. 


6.3 LIBRARY 


LIBRARY creates and maintains uSser-written library files, or 
libraries. Libraries can contain macro definitions, object modules, 
or, in the case of universal libraries, anything. 


Maintenance functions of LIBRARY include extracting, deleting, 
inserting, and replacing library entries. Libraries can be compressed 
(squeezed) to save disk space. Library contents can also be listed. 


User-written object module libraries can be used as input to the Task 
Builder, either directly or through LINK. The Task Builder (TKB) 
searches for definitions of all global symbols referenced in your 
program in the following fashion. First, TKB searches other modules 
included in the LINK command, then it searches a user-written object 
module library included in the LINK command, and finally it searches 
the system library. 


User-written macro libraries hold source macros for use as input by 
the MACRO-11 Assembler, either directly or through MACRO. The 
assembler searches the library you specify for macros listed in .MCALL 
statements and called in your source program before searching the 
system macro library. 


In general, LIBRARY handles object module libraries and macro 
libraries in the same way. This means that references in this section 
to modules can be usually taken as referring to macros as well as 
object modules. 


Libraries are direct access files containing one or more modules of 
the same type. These files are organized for rapid access by the Task 
Builder and MACRO-11 Assembler. Universal libraries can contain 
virtually anything to which you wish to have rapid access, such as 
text files. 


Library files contain two directory tables. The entry point table 
(EPT) contains entry point names (global symbols). The module name 
table (MNT) contains module names. Both tables are in alphabetical 
order. Object module names are derived from .TITLE directives, while 
entry point names are derived from defined global symbols. Once an 
entry point is located, its associated module can be accessed 
directly. Macro module names are derived from .MACRO directives; 
macros are linear code and do not have entry points. 


This section does not teach you how to use the Librarian utility, but 
only how to use the LIBRARY command. See the Notes for suggested 
further reading. 
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Format 


LIBRARY 
Operation? operation[/qualifier[s] ] 


LIBRARY operation[/qualifier[s]] 
LIBRARY @filespec 
LIBRARY performs the following operations: 


COMPRESS CREATE DELETE EXTRACT INSERT 
LIST REMOVE REPLACE 


Each of these operations is treated as a separate command in this 
description. 


Notes 


LIBRARY invokes the Librarian Utility Program (LBR). To use this 
command successfully, you must familiarize yourself with this 
utility, which is described in Chapter 10 of the RSX-11M/M-PLUS 
Utilities Manual. 


LBR format differs from the format of the DCL LIBRARY command. 
DCL translates the DCL command line into LBR format. The 
descriptions presented here include cross-references to the 
equivalents in LBR format of the DCL command elements. Use the 
SET DEBUG command to see the translation. 


If you wish to use indirect command files with LIBRARY, the 
indirect command file must be in LBR format, not DCL format. 
Only one level of indirect referencing is permitted. 


You should also be familiar with the way the MACRO-11 Assembler 
and the Task Builder use libraries. See the IAS/RSX-11 MACRO-11 
Reference Manual, the RSX-11M/M-PLUS Task Builder Manual, and the 
RSX-11M/M-PLUS Guide to Program Development for more information. 


You cannot use wiidcards (*, %) in file specifications in LIBRARY 
operations. 


Library modules are limited to 65536 words per module. 
Libraries are limited to 65536 blocks. 
The LIBRARY command operates on three kinds of libraries: 


@ Object module libraries. These can be user libraries or 
one of the following DIGITAL-supplied libraries: 


LBO: [1,1]SYSLIB.OLB System library (this is’ the 
library searched by the Task 
Builder by default). 


LBO: {1,1j]VMLIB.OLB Virtual Memory Management 
library 
LBO:[1,11EXELIB.OLB Executive library 
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LBO:[{1,1L]RMSLIB.OLB Record Management Services 
library 

LBO: [1,1] FOROTS.OLB FORTRAN IV library (optional) 

LBO: [1,1] F4POTS.OLB FORTRAN-IV-PLUS library 
(optional) 


® Macro libraries. These can be user libraries or one of 
the following DIGITAL-supplied libraries: 


LBO: [1,1]RSXMAC.SML System macro library. This 
is the library searched by 
the assembler by default. 
(Note nonstandard file type) 


LBO: [1,1] EXEMAC.MLB Executive macro library 
LBO: {1,1]RMSMAC.MLB Record Management Services 
library 


The Librarian utility can also be used to create and maintain a 
third form, universal libraries, using the /UNIVERSAL qualifier 
on some of the LIBRARY commands. 


The LIBRARY command and utility have no relationship to the other 
kinds of libraries used on RSX-11M/M-PLUS systems. Specifically, 
LBR has no relationship to supervisor mode libraries or 
core-resident iibraries created by the Task Builder. 


The /SQUEEZE qualifier causes all text to the right of the 
rightmost semicolon to be deleted. This convention permits you 
to preserve any meaningful semicolon by adding another semicolon 
to its right. Examples of meaningful semicolons include using 
the ASCII value of the semicolon in code, or a semicolon marking 
a comment you wish to preserve. The following line of code moves 
the ASCII value of the semicolon to register 1: 
MOVB #03) RL 
but emerges after the /SQUEEZE as 
MOVB #! 
To preserve the meaningful semicolon, use the following form: 
MOVB #';, RL ; THIS DUMMY COMMENT SAVES THE CODE 
which emerges after the /SQUEEZE as 


MOVB #';, RI 
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Similarly, the following comment: 
;NEXT 5 LINES ARE CRUCIAL 

disappears after the /SQUEEZE, but this form 
;NEXT 5 LINES ARE CRUCIAL ; 

emerges after the /SQUEEZE as 
;NEXT 5 LINES ARE CRUCIAL 


Keep this convention in mind whenever you are using the /SQUEEZE 
qualifier. 


All error messages are described in Section 6.3.9. Some error 
messages are closely related to particular LIBRARY operations. 
Descriptions of these messages are repeated in the section on the 
operation to which they pertain. 


6.3.1 LIBRARY/COMPRESS 


LIBRARY/COMPRESS physically deletes modules that have been logically 
deleted through LIBRARY/DELETE. You can rename the resulting 
compressed library. 


Format 


LIBRARY/COMPRESS{: (arg[{,s])] libspec [newlibspec] 
GLOBAL:n 
MODULES: n 
BLOCKSi:n 


Parameters 
libspec 


Specifies the name of the library file to be compressed. The 
default type is .OLB, specifying an object module library. If 
you wish to compress a macro library (standard file type .MLB), 
or a universal library (standard file type .ULB), you must 
specify the file type explicitly. 


newlibspec 


This optional parameter specifies a name for the newly compressed 
library. If you do not specify a name, the new file has the same 
name as the old one. The old file is not deleted after you 
create a new library with this command. 


Arguments 
If you are specifying more than one argument, the arguments must 


be enclosed in parentheses and separated by commas. If you are 
specifying only one argument, the parentheses are not necessary. 
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GLOBALS:n 


The GLOBALS argument specifies the number of global symbols 
(entry point table entries) to allocate. The default n is the 
number of global symbols allocated in the old library. The 
maximum n is 4096. The value of n is always forced to zero for 
macro and universal libraries. 


MODULES:n 


The MODULES argument specifies the number of entries to allocate 
in the module name table. The default value is the number of 
entries in the old library. The maximum number of module names 


is 4096. 

BLOCKS:n 
The BLOCKS argument specifies the size of the library in 256-word 
blocks. The default size is the size of the old library. 


Example 
PLIBRARY/COMPRESS LR TisiISYSLIB, OLE 
This example compresses the system object module library. 
Notes 


This command is equivalent to the LBR /CO switch applied to a 
library file. 


If you like, you can use LIBRARY/LIST before and after 
compressing a library to see the effects of the compress 
operation. 


6.3.2 LIBRARY/CREATE 


LIBRARY/CREATE creates a library and optionally inserts one or more 
modules into it. 


The library is a contiguous file created on a volume mounted on a 
random-access device, that is, disk or DECtape. 


Format 


LIBRARY/CREATE[: (arg[,S})]{/qualifierf{s]] libspec [infilespec[,s]] 
GLOBALS:n 
MODULES:n 
BLOCKS:n 


Command Qualifiers 


7 {NO]GLOBALS 

/ MACRO 

/OBJECT 
/SELECTIVE SEARCH 
/SQUEEZE 
/UNIVERSAL 
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Parameters 
libspec 


Specifies the name of the library file being created. The 
default file type is .OLB if an object module library is being 
created, .MLB if a macro library is being created, and .ULB if a 
universal library is being created. 


infilespec[s] 


Specifies the file or files to be used as input to the new 
library file. If no input files are specified, an empty library 
file is created. The default file types are .OBJ when creating 
object module libraries, .MAC when creating macro libraries, and 
-UNI when creating universal libraries. 


Arguments 


If you are specifying more than one argument, the arguments must 
be enclosed in parentheses and separated by commas. If you are 
specifying only a single argument, the parentheses are not 
necessary. 


GLOBALS:n 


The GLOBALS argument specifies the number of global symbols 
(entry point table entries) to allocate. The default is 512 for 
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MODULES:n 


The MODULES argument specifies the number of entries to allocate 
in the module name table. The default value is 256. n can be 
from 0 through 4096. 

BLOCKS:n 


The BLOCKS argument specifies the size of the library in 256-word 
blocks. The default size is 100 blocks. 


Command Qualifiers 
/ {NO] GLOBALS 


/NOGLOBALS specifies that global symbols are not to be included 
in the entry point table. 


Use this qualifier if you wish to use the same global symbols in 
more than one module. /GLOBALS is the default but is a no-op. 


/ SELECTIVE SEARCH 


Sets the selective search attribute bit in the module header of 
object modules as they are inserted into an object library. You 
must specify an input file or files. 
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Object modules with the selective search attribute are given 
special treatment by the Task Builder. Global symbols defined in 
modules with the selective search attribute are only included in 
the Task Builder's symbol table if they were previously 
referenced by other modules. 


/SQUEEZE 


The /SQUEEZE qualifier reduces the size of macro definitions by 
eliminating all trailing blanks and tabs, blank lines, and 
comments from macro text. You must specify an input file or 
files. 


This qualifier has meaning for macro libraries only. 


Macros that have been squeezed not only take up less room in the 
macro library file, but also take up less memory. 


See the Notes to Section 6.3 for important information on the 
/SQUEEZE qualifier. 


This /SQUEEZE qualifier is the equivalent of the LBR /SZ switch 
applied to the output library file when using the /CR switch. 


/MACRO 


The /MACRO qualifier specifies that the library being created is 
a macro library. 


/OBJECT 


The /OBJECT qualifier specifies that the library being created is 
an object module library. This is the default and need not be 
specified. 


/UNIVERSAL 


The /UNIVERSAL qualifier specifies that the library being created 
is a universal library. 


Example 


=sLIBRARY 

Oreration? CREATE: (GLOBALS?128»MODULES:? 64) 
Library? CARNEGIE 

Modules? DEWEY»CONGRESS+MODERN 


This example creates the library CARNEGIE.OLB with a size of 100 
blocks (the default), 128 entry points, and 64 module names, and 
inserts object modules from the input files DEWEY.OBJ, 
CONGRESS.OBJ, and MODERN.OBJ. 


Notes 


This command is the equivalent of applying the LBR /CR switch on 
the output file. 
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Tables. should be allocated to maximum anticipated size. 
Expanding table allocations requires using LIBRARY/COMPRESS to 
copy the entire file. 


If the qualifiers /SELECTIVE SEARCH and /SQUEEZE are used with 
LIBRARY/CREATE, you must specify an input file or files. 


6.3.3 LIBRARY/DELETE 


LIBRARY/DELETE deletes modules from any library. See LIBRARY/REMOVE 
for removing global symbols (entry points) from a library. 


Format 

LIBRARY/DELETE lLibspec module[,s] 
Parameter 
libspec 


Specifies the name of the library from which modules are to be 
deleted. 


module[,s] 


You can specify as many as 15 names of modules to be deleted, 
separated by commas. 


If you do not specify the module list, you will be prompted for 
Les 


Example 


sLIBRARY/DELETE 
Library? BUMPERS 
Module(s)? BUGGY, BABY: RUBBER 


Modules deleted} 


BUGGY 
BABY 
RUBBER 


This example deletes the modules BUGGY, BABY, and RUBBER from the 
latest version of the object module library BUMPERS.OLB. 


Notes 


This command is the equivalent of the LBR /DE switch applied to 
the output file. 


When you delete an entry from a library, the entry is not 
physically removed, but is marked for deletion. This means that 
although the module is no longer accessible, the file space it 
occupied is not available. To clear this space, use the 
LIBRARY/COMPRESS operation, Section 6.3.1. 
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If a specified module is not contained in the library, the 
following message is printed on your terminal: 


LBR -- *FATAL*--No module named "name" 
All the modules in your list up to the incorrect module name will 
have been deleted. None of the modules following the incorrect 
module name will have been deleted. You should use LIBRARY/LIST, 


Section 6.3.6, to check which modules have been deleted and which 
have not. 


See LIBRARY/REMOVE (Section 6.3.7) for information on removing 
global symbols from libraries. 


6.3.4 LIBRARY/EXTRACT 


LIBRARY/EXTRACT reads one or more modules from a library and writes 
them into a specified output file. 


You can extract up to eight modules with a single LIBRARY/EXTRACT 
operation. If more than one module is extracted, the modules are 
concatenated in the output file. 


Format 
LIBRARY/EXTRACT/qualifier[:filespec] libspec module[,s] 
Command Qualifier 
/OUTPUT[:filespec] 
Parameters 
libspec 
Specifies the library from which modules are to be extracted. 


The default file type is .OLB, corresponding to an object module 
library. If you wish to extract from a macro or universal 
library, you must specify the appropriate file type. 


module[,s] 


Specifies the modules that are to be extracted. If you do not 
include a list, all modules in the library are extracted and 
concatenated in the output file in alphabetical order. You. can 
specify up to eight modules, separated by commas. 


Command Qualifier 


The /OUTPUT qualifier specifies the file to which the extracted 
modules or macros are to be written. If you specify /OUTPUT 
without a filespec, the default is to write the modules to _ your 
terminal. This makes sense only for macro libraries or universal 
libraries containing text modules. 


If you do not include the qualifier, you will be prompted To?, to 


which you are to reply with a filespec. You can reply TI: to 
have the output printed on your terminal. 
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Examples 
SLIBR/EXTRACT/OUTFUTIMATH LROT CLs 1 ISY Slik ARITH 
This example extracts the module named ARITH from the library 


SYSLI8.OLB, the system object library. The module is placed in 
the default directory as a file named MATH.OBJ. 


“LIBR/EXTRACT/OUTiTI LROTCLsLIRSXMAC.SML STORSS 
*+MACKG STOPES ERR 


*+MCALLO DIRS 

MOY CFC) +te- (SP) 
+BYTE 131. rj 

DIRS rERR 


»ENLIM STORES 


This example extracts the macro named STOPSS from the system 
macro library and prints it on the terminal. 


Notes 


This command is the equivalent of the LBR /EX switch applied to 
the library file as an input file. 


LIBRARY/EXTRACT has no effect on the library from which the 
modules are extracted. 


6.3.5 LIBRARY/INSERT 
LIBRARY/INSERT inserts modules from one or more files into a library. 
Format 
LIBRARY/INSERT libspec filespec[,s] 
Command Qualifiers 
/ [NO] GLOBALS 
/SELECTIVE SEARCH 
/ SQUEEZE 
Parameters 
libspec 
Specifies the library into which modules are to be inserted. 
The default file type is .OLB. If you wish to insert modules 
into a macro library (file type .MLB) or a universal library 
(file type .ULB), you must specify the file type explicitly. 


filespec{[s] 


Specifies the file or files containing concatenated modules to be 
inserted into the specified library. 


Any number of files can he specified and each file can contain 
any number of concatenated modules. 
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The default file type is determined by the library into which 
modules are being inserted. It is .MAC for macro libraries and 
-OBJ for object module libraries, and .UNI for universal 
libraries. 


Command Qualifiers 
/ [NO] GLOBALS 


/NOGLOBALS specifies that entry points for the specified modules 
are not to be included in the entry point table. 


Use this qualifier if you wish to insert global symbols having 
the same name as symbols already in the library file. The 
default, /GLOBALS, does not permit this operation. 


/SELECTIVE SEARCH 
Sets the selective search attribute bit in the module header of 
object modules as they are inserted into an object library. You 
must specify an input file or files. 
Object modules with this attribute are given special treatment by 
the Task Builder. Global symbols defined in modules with the 
selective search attribute are not included in the Task Builder's 
symbol table unless they were previously referenced by other 
modules. 

/SQUEEZE 


Reduces the size of macro definitions by eliminating all trailing 
blanks and tabs, blank lines, and comments from macro text. You 
must specify an input file or files. 


Macros that have been squeezed not only take up less room in the 
macro library file but also take up less memory. 


See the Notes to Section 6.3 for important information on the 
/SQUEEZE qualifier. 


This qualifier is the equivalent of the LBR /SZ switch applied to 
the output file. 


Example 
»LIBR/INSERT 
Library? LBO?Ci»LISYSLIB 


Moduleds)? USERSUE 


This example inserts object modules from the file USERSUB.OBJ 
into the system object module lbrary, LBO:[1,1]SYSLB.OLB. 


Notes 
This command is the equivalent of the LBR /IN command. 


Note that a single input file can contain more than one object 
module or macro. 


If you are inserting macros into a macro library, LIBRARY/INSERT 
insert only the .MACRO and .ENDM lines and what appears between 
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them. All text in the file not bracketed by these assembler 
directives is ignored. This feature is in addition to the action 
of the /SQUEEZE qualifier. 


If you attempt to insert a module that already exists in the 
library file, the following message is printed on your terminal: 


LBR -- *FATAL*Duplicate module name "name" in filename 


If you attempt to insert a module with an entry point that 
duplicates one that is already in the EPT, the following message 
is printed on your terminal: 


LBR -- *FATAL*Duplicate entry point "name" in filename 
In the case of either of these messages, all operations up to the 
point at which the error occurred should have been successful. 
No operations past that point will have taken place. Use 


LIBRARY/LIST to check which modules have been inserted and which 
have not. 


6.3.6 LIBRARY/LIST 


LIBRARY/LIST lists the names of all modules in a library on your 
terminal or in an output file. 


eoemee 
LIBRARY/LIST[:filespec] libspec 
Command Qualifiers 
/BRIEF 
/FULL 
/ [NO] NAMES 
Parameter 
libspec 
Specifies the library you wish listed. The default file type is 
-OLB. If you wish to list a universal or macro library, you must 
specify the appropriate file type. 
Command Qualifiers 


/LIST([:filespec] 


If you do not include a filespec as an argument to /LIST, the 
library is listed on your terminal. 


If you include a filespec as an argument, the default device and 
UFD are the same as those of the library you are listing and NOT 
your current defaults. See the examples. 


/BRIEF 
The /BRIEF qualifier specifies that you wish the list to include 


only the module names. This is the default. See the examples. 
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The /FULL qualifier requests a listing of all module names, along 
with a module description, including size, date of insertion, and 


module-dependent information. See the examples. 


NAMES 


The /NAMES qualifier requests a list of modules in the 
along with their entry points. The default is /NONAMES. 
examples. 


Examples 


SLIBRARY/LIST LERO?UL,1ISYSLIB 


Directory of file SYSLIB-OLE#19002 

OdJect module library created byl: LER ¥06.90 
Last insert occurred 25-NOV-8e at 19134532 
MNT entries allocated! 74683 Availenblei S34? 
EFT entries gllocated: 2048) Aveileble: 673 
File srace available? 00307 words 
Recoverable deleted srace? 14892 words 


-ALERR 
ALSCT 
ALTFRI 
ANSFAT 
ARITH 


% 


library, 
See the 


This example shows the default display from LIBRARY/LIST. 


the module names appear. The information appears 
terminal. 


SLIBRARY/LIST/FULL LRO?CL+LISYSLIB 


firectorys of file SYSLIK.OLE#1002 

Object module liobrars crested oyi LR YO6.96 
Last insert occurred 2S-JUN-79 et 19534532 
MNT entries alloceted! 748: Aveilablei S49 
EFT entries allocated? 2948! aveilebleit 875 
File sreece aveilable?i 60307 words 

Recoveraole deleted space? 14892 words 


ALERR SizeiO0073 Ingertledi2e-OfT-s2  Ldentsas 
ALSCT Si2e@:00134 Insertedi22-JF7T-8a2 Tdentigo 
ALTFRI Sizes;00081 Inserbtedi22-OCT-S2  Vdermbiga 
ANSPALR SizeiO00é8 Insertedi2S-NOV-82 Tdenti2o.oR4 
ARITH Sizei90088 Inserted? 22-OCT-82 Idermtiog.a3 


+ 


o 
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This example shows the display from LIBRARY/LIST/FULL, which 
includes full module descriptions. This information appears on 
your terminal. 

S*LIBRARY/LIST/NAMES LEO?iC1s1ISYSLIE 

Tlirectory of file SYSLIE.OLB#1002 

Object module library created ov? LBR ¥96.00 

Last insert occurred 25-NOV-82 at 19:34:32 

MNT entries sllocated! 748? Availseblei 349 

EFT entries allocated! 2060483 Availeblei? 873 

File sPace availsole? 060309 words 

Recoverazole deleted sracei 14892 words 


#*X ModuleiALERR 


$ALERR 


KK ModuleiALSCT 


ALSCT 


kX ModulesALTFRI 


ALTFRI 


KK ModuletANSPADL 


++ ANSP 


** ModuletARITH 


$0Iy $MUL 


+ 


¢ 


This example shows the display from LIBRARY/LIST/NAMES, which 
lists entry points for each module. 


SLIBRARY/LIST/FULL/NAMES LBOi LL, 1ISYSLIB 


Directory of file SYSLIB.OLBI19002 

Object module library crested txt LEBER ¥O6.900 
Last insert occurred 25-NOV-82 et 19°7344°32 
MNT entries sllocatedi! 7683 Avsilablei Sa 
EFT entries allocated: 20483 Available? 873 
File srace available! 002307 words 

Recoversoie deleted rece: L4s7e words 


KK MNoduletALERR SizeiOdgo73 Insertedi#2-O87T-82 IRdentioG 


$ALERR 
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¥*X ModuletALSCT Sizei00134 Inserted! 22-O0OCT-82 Identio0 
ALSCT 

¥*¥ ModuletALTPRI SizeiOO0081 Inmsertegi22-OCT-82 I[dentioad 
ALTFRI 

¥X ModuleiANSPAD Sizeio0068 Insertedi25-OCT-S2 Identi2o.oré 
++ ANSP 


KX ModuleiARITH Size:00088 Insertedi22-OCT-82 [dentioz,oF 


, 


This example shows the display from LIBRARY/LIST/FULL/NAMES, 
which includes not only module descriptions but also entry points 
for each module. 


>sSHOW DEFAULT 


DR2¢ [€303754 TTS463 
PLIBRARY/LISTIFRED.LIS LBOSCisLISYSLIB 


LEBER -- X*FATALK-Oren fseilure on file FRED.LIS 


In this example, the user intended to create a list of the 
modules in SYSLIB in the default UFD on the default device. The 
error message indicates that the listing file cannot be opened. 
This is because LBR attempted to place FRED.LIS on LBO: in 
[1,1], where the user did not have file creation privileges. See 
next example. 


=>SHOW DEFAULT 
QR2; (£303:5) TTS6: 
SLIBRARY/LISTSOR2IC SOSxSIFREU.LIS LROTLL»LISYSLIE 


In this example, the user explicitly stated the device and UFD 
for the listing file and the command succeeded. 
Notes 


This command is the equivalent of applying the LBR /LI, /FU, or 
/LE switches to the listing file. 


Note that there are four possible listing formats with this 
command. 
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6.3.7 LIBRARY/REMOVE 


LIBRARY/REMOVE removes global symbols (entry points) from a library. 
See LIBRARY/DELETE for deleting object modules from a library. 


Format 

LIBRARY/REMOVE libspec global [global[,s]] 
Parameters 
libspec 


Specifies the name of the library from which you wish to remove 
global symbols. 


global[,s] 


Specifies the globals you wish to remove from the library. You 
can specify as many as 15 global symbols. 


Example 
’LIBRARY/REMOVE DOUBLE TINKER» EVERS» CHANCE 
Entry Foints deleted? 
TINKER 
FEVERS 


CHANCE 


This example deletes the globals TINKER, EVERS, and CHANCE from 
the library DOUBLE.OLB. 


Notes 


This command is the equivalent of the LBR /DG switch applied to 
the output file. 


If a specified global is not included in the library, the 
following message is printed on your terminal: 


LBR -- *FATAL* -- No entry point named "name" 


All the global symbols (entry points) in your list up to the 
incorrect name will have been deleted. None of the globals 
following the incorrect name will have been deleted. You should 
use LIBRARY/LIST (Section 6.3.6) to check which globals have been 
deleted and which have not. 


6.3.8 LIBRARY/REPLACE 


LIBRARY/REPLACE replaces a module in a library with a new module of 
the same name and deletes the old moduie. 


When a match occurs on a module name, the existing module is logically 
deleted and all its entries are removed from the qlobal symbol table. 
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Format 
LIBRARY/REPLACE libspec filespec[,s] 


Command Qualifiers 


/ {NO]GLOBALS 
/ SELECTIVE SEARCH 
/ SQUEEZE 
Parameters 
libspec 
Specifies the library in which modules are to be replaced. The 


default file type is .OLB, corresponding to object libraries. If 
you wish to replace macros in a macro library (file type .MLB) or 
a universal library (file type .UNI), you must specify the file 
type explicitly. 


filespec[,s] 


Specifies the file or files containing the new modules. The 
default file type is determined by the type of library in which 
modules are being replaced. It is .OBJ for object module 


libraries, .MAC for macro libraries, and .UNI for universal 
libraries. 


If the module to be replaced does not exist in the Library, 
LIBRARY performs an insert operation. 


If the module to be replaced exists, a message is printed. See 
example. If the module does not exist, it is inserted, but no 
message is printed. 


Command Qualifiers 
/ [NO] GLOBALS 


/NOGLOBALS specifies that entry points for the specified modules 
are not to be included in the entry point table. The default is 
/GLOBALS. 


/SELECTIVE SEARCH 


Sets the selective search attribute bit in the module header of 
object modules as they are inserted into an object library. 


Object modules with the selective search attribute are given 
special treatment by the Task Builder. Global symbols defined in 
modules with the selective search attribute are only included in 
the Task Builder's symbol table if they were previously 
referenced by other modules. 


/ SQUEEZE 


Reduces the size of macro definitions by eliminating all trailing 
blanks and tabs, blank lines, and comments from macro text. 
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Macros that have been squeezed not only take up less room in the 
macro library file but also take up less memory in the assembler 
when they are invoked. 


See the Notes in Section 6.3 for more information on the /SQUEEZE 
qualifier. 


This is the equivalent of the LBR /SZ switch applied to the input 
file. 


Example 
“LIBR/REPLACE LBO?C1isLISYSLIB USERSUB 
MODULE "USERSUB* REFLACED 
This example replaces the modules in the file SYSLIB.OLB with new 
modules bearing the same names in the file USERSUB.OBJ. Entry 
points are also redefined. 
Notes 
This command is the equivalent of the LBR /RP command. 
There must be enough space in the library's tables for both the 
modules being replaced and their replacements since the new 
modules are entered before the old modules are deleted. 
The old modules are logically deleted only. You must use 


LIBRARY/COMPRESS to eliminate the modules tnemseives and free the 
space they occupy. 


6.3.9 Error Messages from LIBRARY 
LIBRARY has two kinds of error messages, diagnostic and fatal. 


Diagnostic messages are marked *DIAG* and inform you of conditions 
that require your consideration but do not warrant termination of the 
command. Depending on the message and the operation, you can decide 
what further action is called for. The operation completes. 


Fatal messages are marked *FATAL* and describe conditions that caused 
LBR to terminate execution of your command. The operation does not 
complete. 


In general, fatal output errors leave the library in an indeterminate 
state. You should use LIBRARY/LIST to determine how much of the 
operation completed before the fatal error occurred. 


Some errors result from corrupted library files. . You can use VFY, the 
File Structure Verification utility, to determine whether a file is in 
Files-11 format. A library file can be in Files-1ll format and _ still 
be corrupted as a library, however. 


If a library file is corrupted, the library must be recreated. 
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Error messages appear on your terminal in the following formats: 
LBR -- *DIAG*-message 
LBR--* FATAL*-message 


Note that error messages from LIBRARY are tagged LBR after the utility 
and not LIB after the command. This is an exception to the general 
rule on DCL error messages. 


LBR -- Bad library header 
Explanation: The file either is not a library or is corrupted. 


User Action: Make sure the file is a library. If the file is a 
library, use VFY, the File Structure Verification utility, to 
determine if it is corrupted. See Chapter 9 of the 
RSX-11M/M-PLUS Utilities Manual. 


LBR -- Command I/O error 


Explanation: There are two possible causes. The problem may be 
with the physical device, such as not being spun up. Or, the 
File may be corrupted or have an incorrect format, such as a 
record length exceeding 132 bytes. 


User Action: Determine the condition that caused the message and 
correct the condition. Reenter the command line. 


LBR -- Command syntax error 
command line 


Explanation: The reprinted command line has a syntax ‘error. 


User Action: Check for proper syntax and reenter the command 
line. 


LBR -- Duplicate entry point name "name" in filename 


Explanation: Your command attempted to insert (not replace) a 
module containing the given entry point name into a library 
already containing an entry point of that name. 


User Action: Make sure you have named the correct input file. 
If not, reenter the command naming the correct input file. If 
the input file is correct, you can delete the duplicate entry 
point from the library and reenter the command. 


LBR -~- Duplicate module name "name" in filename 


Explanation: Your command attempted to insert (not replace) a 
module with the given name into a library that already contains a 
module of that name. 


User Actions: Make sure you have named the correct input file. 
If the input file is correct, you must decide whether or not to 
use LIBRARY/REPLACE to replace the module that is already in the 
library. 
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LBR -- EPT or MNT exceeded in filename 


Explanation: The GLOBAL or MODULE table limit has been reached 
during the execution of a REPLACE or INSERT operation. 


User Action: Copy the library using LIBRARY/COMPRESS and include 
the /MNT or /EPT qualifier to increase table size. 


LBR -- EPT or MNT space exceeded in compress 


Explanation: A GLOBAL or MODULE table size was specified in a 
COMPRESS operation for the output library file that is not large 
enough to contain the EPT or MNT entries used in the input 
library. 


User Action: Reenter the command line with a larger EPT or MNT 
table size specified. 


LBR -- Error in library tables, File "filename" 


Explanation: Either the library is corrupted or it is not a 
library. 


User Action: If the file is corrupted, no recovery is possible. 
The file must be reconstructed. If the file is not a library, 
reenter the command line with the correct file named. 


LBR -- Fatal compress error 


Explanation: The input library on a COMPRESS operation is 
corrupted or is not a library. 


User Action: If the file is corrupted, no recovery is possible. 
The file must be reconstructed. If the file is not a library, 
reenter the command line with the correct file named. 


LBR -~- Get time failed 


Explanation: System error. LBR attempted to execute a Get Time 
Parameters directive and failed. 


User Action: Reenter the command line. If the error is 
repeated, see your system manager. Plan to submit a Software 
Performance Report. Save console dialogue and other pertinent 
information. 

LBR -- Input error on filename 


Explanation: The file system has detected an error. 


User Action: Reenter the command. If the error is repeated, see 
your system manager. 


LBR -- Insufficient dynamic memory to continue 


mn = Ri nn mb ayrhkikg + ah : : i 
Explanation: The partition in which LBR is running is too small. 


User Action: See your system manager. 
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LBR -- Invalid EPT and/or MNT specification 


Explanation: Command included an argument for /MNT or /EPT 
greater than 4096. 


User Action: Check for proper syntax and reenter command. 
LBR -- Invalid module format, insertion-module 


Explanations: Command attempted to insert the named macro 
definition into an object module library. 


User Action: Correct error by reentering command with object 
module for object module library or macro for macro library. 


LBR -- Invalid format, input file filename 


Explanation: Your command named either an input file that is not 
in the standard format or a file that is corrupted. 


User Action: Make sure you have named the right file and reenter 
command. 


LBR -- Invalid library type specified 
Explanation: Your command attemoted to set an illegal library 
type as the default. The file types .OBJ and .MAC are the only 
valid default file types for the command. 
User Action: Reenter command after checking proper syntax. 


LBR -- I/O error on input file "filename" 


Explanation: A read error occurred on an input file. This error 
can have two causes: 


@e A problem with the physical device, such as not being 
spun up. 


e The input file is corrupted or in the wrong format, such 
as records exceeding 132 bytes in length. 


User Action: Determine the cause of the error and correct the 
condition. Reenter the command line. 


LBR -- Library file specification missing 


Explanation: Your command was entered without proper 
specification of the library file. 


User Action: Check for proper syntax and reenter the command. 
LBR -- Mark for delete failure on LBR work file 

Explanation: LBR automatically creates a work file when it 

begins processing commands and marks it for delete. For some 


reason this marking failed. The work file is a lost file and 
does not appear in any UFD. 
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User Action: See your operator or system manager. The file must 
be deleted using VFY, the File Structure Verification utility. 
See Chapter 9 of the RSX-1L1M/M-PLUS Utilities Manual. 

LBR -- No entry point named "name" 


Explanation: Your command named an entry point to be deleted 
that is not in the library. 


User Action: Check command for proper syntax and reenter 
command. You may have misspelled the entry point name or named 
the wrong library. 


LBR -~- No module named "module" 


Explanation: Your command named a module to be deleted that is 
not in the library. 


User Action: Check command for proper syntax and reenter 
command. You may have misspelled the module name or named the 
wrong library. 

LBR -- Open failure on file "filename" 
Explanation: The file system detected an error while attempting 
to open ae file. This error is caused by one of the following 
conditions: 


e The user directory area is protected against a Write 
operation. 


e There is a problem with the physical device, such as not 
being spun up. 


e The volume is not mounted. 
e The UFD does not exist. 
e The file does not exist. 


e There is insufficient space to allocate the library file 
on a LIBRARY/CREATE or LIBRARY/COMPRESS. 


e There is insufficient pool space (DSR) in the Executive. 


User Actions: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 


LBR -- Open failure on LBR work file 


Explanation: The file system detected an error while attempting 
to open the LBR work file. The LBR work file is created on the 
volume from which LBR was’ installed. One of the following 
conditions can cause this error: 


e The volume is full. 


e The device on which the volume is mounted is 


write-protected 
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e There is a problem with the physical device. 
@e There is insufficient pool space (DSR) in the Executive. 


User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 


LBR -- Output error on filename 


Explanation: A write error has occurred on the output file. One 
of the following conditions can cause this error: 


e The volume is full. 


e The device on which the volume is mounted is 
write-protected. 


@e The hardware has failed. 


User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 


LBR -- Positioning error on filename 


Explanation: The device on which the volume is mounted is 
write-locked or some other hardware difficulty exists. 


User Action: Determine the cause of the error if you can. If 
you cannot, see your operator or system manager. 


LBR -- Virtual storage requirements exceed 65536 words 
Explanation: This error may occur with maximum size libraries in 
conjunction with a single command line that logically deletes a 
large number of modules and entry points and continues to replace 
them with an equally large number of modules and entry points 
having highly dissimilar names. Normally, this message indicates 
some sort of internal system error. 


User Action: Rerun the job after dividing the command line into 
several smaller lines that perform the same operations. 


LBR -- Work file I/O error 


Explanation: A write error has occurred on the LBR work file. 
One of the following conditions can cause this error: 


e The volume is full. 


e The device on which the volume is mounted is 
write-protected. 


e The hardware has failed. 


User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 


PROGRAM DEVELOPMENT 


LINK 


6.4 LINKING THE TASK 


After the MACRO-11 Relocatable Assembler or high-level language 
compiler has translated the source program file into a binary object 
file, the object file must be linked or task built. This process 
makes a runnable task out of one or more object files plus object 
modules from user-written or system library files. 


6.4.1 Introduction to the LINK Command 


The LINK command invokes the Task Builder, a system utility that 
builds the tasks, formally called task images, that run on the system. 


The unadorned LINK command includes a number of defaults that produce 
a standard task image file, having the file type .TSK. The Task 
Builder (TKB), however, provides you with many choices that are not 
included in the defaults. You can use qualifiers to the LINK command 
to create TKB output files in addition to the task image file, to 
identify certain kinds of unusual tasks, to use hardware options that 
may not be present on all systems, and in general to control the 
nature of the task build itself. In addition to the LINK command 
qualifiers, there are also Task Builder options that permit you to 
specify characteristics of the task you are building. 


The defaults provide you with a simple means of building a standard 
task. You pass the Task Builder an object file (default file type 
-OBJ) produced by the MACRO-11 Relocatable Assembler or one of the 
high-level language compilers, and the Task Builder produces a 
runnable task image. This is done with a command such as_ the 
following: 


eLINK 
File(s)? SAMPLE 


This command produces a single output file called SAMPLE.TSK. The 
return of the implicit prompt tells you the task build completed 
successfully. 


If, in addition to the task image file, you should want a Task Builder 
map file showing the size and location of parts of the task, issue a 
command such as the following: 


SLINK/MAF SAMPLE 


This produces two output files, SAMPLE.TSK and SAMPLE.MAP. 


SAMPLE.MAP is automatically printed on the line printer and also 
appears in your directory. 


The following command also requests that a map be made: 


ZbLINK SAMFPLE.OBJ/MAF 


o 


This produces two output files; SAMPLE.TSK and SAMPLE.MAP. SAMPLE.MAP 
appears in your directory but is not printed on the line printer. 
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If you are linking more than one object module to form a task, the 
Task Builder, by default, names the output files after the first task 
named in the command line. For example, the command 


*LINK MOE» CURLY: LARRY 
produces a task image file named MOE.TSK. Use the /TASK qualifier to 
change the name of the task image file. For instance, the command 


SLINK/TASKiSHEMP MOE? CURLY: LARRY 


produces a task image file named SHEMP.TSK. Or, use the command 


ZLINK MOE+ CURLY/TASK+: LARRY 


to produce a task image file named CURLY.TSK. 
Note, however, that the command 


SLINK/MAP MOE? CURLY/TASK: LARRY 


produces a task image file named CURLY.TSK and a map file named 
MOE.MAP. 


If, in addition, you want the task build to abort after the Task 
Builder finds three errors, issue a command such as this: 


sLINK/MAP/ERROR LIMIT! 3 SFPARKY 


This produces two output files, the task image and the map, as before. 
In addition, if the Task Builder finds three errors, it sends a 
message to your terminal and aborts the task build. 


Finally, there are Task Builder options. If you specify the /OPTION 
qualifier in your LINK command, you will be prompted for further 
input. For instance, 


sLINK/MAF/OFPTIONS BIGJON 
Ortion? UNITS=7 


The UNITS option specifies the number of I/0 units for the task. 
There are more than two dozen options you can specify. They are 
listed in Table 6-3. 


If you wish to specify options, there are two ways of doing so. You 
must first include the /OPTION qualifier in your LINK command. You 
will be prompted Option? Then: 


1. You can specify options on separate lines. Simply enter an 
option with its arguments and press RETURN. You will be 
prompted Option? until you terminate the prompt with just a 
RETURN. 
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2. You can specify them in a separate file and name the file in 
response to the Option? prompt with an at sign (@). 


Here are two examples. 


>LINK/MAFP/OFTIONS BIGJON 
Oetion? UNITS=7 

Ortion? ASG=SYOtGi? RET 
Ortion? ED 


or 


<LINK/MAF/OF TIONS BIGJON (RET 
Ortion? @SPARKY.CNI @ET 
Oetion? 


These commands are all DCL commands and the format is DCL format. The 
Task Builder, however, does not recognize DCL format. It recognizes 
only Task Builder format. The translation from DCL format to TKB 
format is performed by DCL. 


Issuing the LINK command to DCL initiates the following process: 


l. DCL reads the command line and checks it for correct DCL 
format. 


2. DCL translates the command line into correct TKB format. 


3. DCL places the TKB-format command in a TKB indirect command 
file and passes the indirect command file to the Task 
Builder. 


4. The Task Builder builds the task as directed and creates all 
requested output files. 


5. The Task Builder returns control to DCL and DCL deletes’ the 
TKB indirect command file. 


If you are building standard tasks using the defaults and following 
the examples given in the command description (Section 6.4.2), this 
process will serve you well. 


However, you will have to refer to the RSX-11M/M-PLUS Task Builder 
Manual for information on how the Task Builder responds to your LINK 
command. The Task Builder manual explains all the output files 
produced by TKB and how TKB interprets your LINK command. All the 
options are explained in the manual, all the terms used in the _ TKB 
environment are defined, and, in general, the capabilities of this 
complex and flexible software tool are elucidated. 


The description of the LINK command in this manual is not intended to 
teach you how to use the Task Builder, but only to teach you how to 
use the LINK command. To learn to use the Task Builder, you must go 
to the Task Builder manual. 
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Since TKB format and DCL format are different, this may be difficult 
at first. The TKB translation of your LINK command is available to 
you in two forms. First, you can use the SET DEBUG command (Section 
1.2.15), which echoes on your terminal the translation of any DCL 
command. Second, you can use the /SAVE qualifier to LINK. The /SAVE 
qualifier preserves the indirect command file created by DCL to be 
passed to the Task Builder. This file is named ATLNK.TMP. This file 
is also useful if you wish to repeat a particular task build. See the 
discussion of /SAVE. 


The following description should help you switch from DCL format to 
TKB format. 


In TKB format, you name any output files you want produced, separated 
by commas, to the left of an equal sign (=). The order you name them 
determines which output files you receive. 
The DCL command 

2 LINK SAMPLE.OBJ 


produces the following command in TKB format in the TKB indirect 
command file: 


TKE> SAMPLE. TSK=SAMFPLE.OBL 
In each case, the Task Builder takes SAMPLE.OBJ as its input file and 
produces as its only output file the task image SAMPLE.TSK. The task 
image file takes the first position in the list of TKB output files to 
the left of the equal sign (=). 
The DCL command 

’LINK/MAF SAMPLE.OBJ 
produces the following command in TKB format: 


TRE? SAMPLE.TSKsSAMPLE.MAP=SAMPLE.OBJ 


In each case, the Task Builder takes SAMPLE.OBJ as its input file and 
produces two output files, SAMPLE.TSK and SAMPLE.MAP. The map file 
takes the second position in the list of TKB output files to the left 
of the equal sign. 


The third kind of output file produced by the Task Builder is called a 
symbol definition file and has the file type .STB. 


The DCL command 
2» LINK/MAP/SYMBOL_TABLE SAMPLE.ORS 
produces the following command in TKB format: 
TKE> SAMPLE.TSKsSAMFPLE.MAFP sSAMFLE.,STBR=SAMPLE.OBJ 
In each case, the Task Builder takes SAMPLE.OBJ as its input file and 
produces three output files, SAMPLE.TSK, SAMPLE.MAP, and SAMPLE.STB. 


The symbol definition file takes the third position in the list of TKB 
Output files to the left of the equal sign. 
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In TKB format, you can add switches, consisting of a slash and _ two 
letters, to each of these output file specifications to alter the 
output file. 
For instance, the DCL command 
“LINK/CODEVFIS SAMFLE.OBS 
produces the following command in TKB format: 
TKBSSAMPLE.TSK/FR=SAMFLE. OBL 


In each case, the Task Builder builds a task that uses the Floating 
Point Processor, which is optional hardware. 


Qualifiers can also be used on map files. The DCL command 
2LINK/CROSS.REFERENCE SAMPLE .ORJ 

produces the following command in TKB format: 
TRE>SAMPLE,. TSE + SARFLE. MAP /SER=SANFILE.OE J! 

In each case, the Task Builder map includes a listing of symbol 

cross-references in the program. DCL does not require you to use the 

/MAP qualifier if you use another qualifier, such as /CROSS REFERENCE, 


that implies that you want a map file. 


In the description of the LINK command that follows. each DCL 


ee 


qualifier is identified with its equivalent in TKB format. 
You can invoke the Task Builder from DCL in four ways: 
e Issuing the LINK command with DCL qualifiers 


@ Invoking a DCL indirect command file including a LINK command 
with DCL qualifiers, such as DCL>@LINKFILE 


e Issuing the LINK command and calling a TKB indirect command 
file, such as DCL>LINK @TKBFILE 


e Running the Task Builder with RUN STKB and issuing TKB 
commands 


The first two methods of invoking the Task Builder require the LINK 


command and DCL format. The latter two methods require commands in 
TKB format. 


6.4.2 LINK 


LINK invokes the Task Builder, which links object modules and routines 
from user and system libraries to form an executable task. 


If you are using LINK with the COBOL-81 compiler, please see Section 
6.4.3, which describes the LINK/C81 command. 
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Format 
LINK[/qualifier[s]} filespec[/qualifier[s]][,filespec[,s]] 
Command Qualifiers 


/ ANCILLARY PROCESSOR[:n] 
/ [NO] CHECKPOINT: arg 
SYSTEM 
TASK 
/CODE: (arg[,s]) 
DATA “SPACE 
EAE 
FPP 
PIC 
POSITION INDEPENDENT 
/COMPATIBLE a 
/{NO]CROSS REFERENCE 
/ [NO] DEBUG[:filespec] 
/ [NO] EXECUTABLE[:filespec]} 
/ERROR_LIMIT:n 
7 [NO] EXTERNAL 
/FAST 
/FULL SEARCH 
/ {NO]HEADER 
/{NO]IO PAGE 
/LONG 
/MAP[:filespec] 
/{NO]MEMORY MANAGEMENT [:n] 
/OPTIONS[:optionsspec] 
/OVERLAY DESCRIPTION 
/ POSTMORTEM 
/ (NO] PRIVILEGED[:n] 
/ [NO] RECEIVE 
/[{NO]RESIDENT OVERLAYS 
/ SAVE a 
/ {NO] SEGREGATE 
/ SEQUENTIAL 
/ SHAREABLE[:arg] 
COMMON 
LIBRARY 
TASK 
/ SLAVE 
/ SLOW 
/SYMBOL TABLE[:filespec] 
/{NO]SYSTEM LIBRARY DISPLAY 
/{NO] TASK{:filespec] 
/TKB 
/ TRACE 
/ [NO] WARNINGS 
/WIDE 


File Qualifiers 


/ [NO] CONCATENATE 

/DEFAULT LIBRARY 

/ [NO] GLOBALS 

/LIBRARY 

/ INCLUDE: (modulel[:...:modulen] ) 
/OVERLAY DESCRIPTION 

/SELECTIVE SEARCH 
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Parameter 
filespec[s] 


Specifies the file or files to be linked. The default file type 
is .OBJ for object modules and .OLB for object module libraries. 


You can have any number of object modules as input files, 
separated by commas. These can be specified in any order. If, 
however, one or more input files must reference an object library 
(.OLB) file, the .OLB file must be entered in the list of input 
files directly after the files that reference it. 


Command Qualifiers 
/ ANCILLARY PROCESSOR [:n] 


Identifies the task as an ancillary control processor (ACP). The 
parameter n specifies the base relocation register. Acceptable 
values are 0, 4, or 5. The default is 5. 


In TKB format, apply the /AC switch to the .TSK filespec. 


/(NO] CHECKPOINT: arg 
SYSTEM 
TASK 


Specifies that the task is to be (or is not to be) 
checkpointable. Checkpointability of tasks is an important part 
of the operating system's ability to share resources. When a 
higher priority task seeks access to system memory, a 
checkpointable task of lower priority is checkpointed, or rolled 
out to the disk to be stored in its current state until the 
higher priority task exits, whereupon the lower priority task 
returns and takes up where it left off. 


If you do not use the /CHECKPOINT qualifier, your task is built 


noncheckpointable. The default is /NOCHECKPOINT. A 
noncheckpointable task cannot be dislodged by a task of higher 
priority. Therefore, you should always build your tasks 


checkpointable unless you have some important reason for not 
doing so. 


You can specify how the checkpointing of the task is handled 
through the arguments to the /CHECKPOINT qualifier. Your task 
can be checkpointable to the system checkpoint file with the 
SYSTEM option. This is the default. LINK/CHECKPOINT and 
LINK/CHECKPOINT:SYSTEM are equivalent commands. 


Tasks built with system checkpointing cannot be checkpointed if 
the system checkpoint file is full. (The size of this file is 
set with the SET DEVICE command.) 


You can also reserve checkpoint space for the task as part of its 
own task image file by using LINK/CHECKPOINT: TASK. Such tasks 
are always checkpointable. (if there is no system checkpoint 
file, you can only run one copy of such tasks.) 
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It should be apparent that the checkpointability of a task has an 
impact on the efficient operation of the entire system as well as 
on the task itself. If the task is built noncheckpointable, it 
can block more important tasks from running. If it is built with 
task checkpointability, mass-storage space is reserved that may 
never be used. If it is built with system checkpointability, 
there may be no room for it in the system checkpoint file. 


Check with your system manager for advice on the preferred 
selection among these checkpointing qualifiers. 


In TKB format, for /CHECKPOINT:SYSTEM, apply the /CP switch to 
the task image file. For /CHECKPOINT: TASK, apply the /AL switch 
to the task image file. For /NOCHECKPOINT, apply the /-CP switch 
to the task image file. 


/CROSS_REFERENCE 


Specifies that a listing of symbol cross-references is to be 
appended to the Task Builder map file. 


If you include this qualifier, you automatically include the /MAP 
qualifier as well. You do not need the /MAP qualifier unless you 
wish to supply a name for the map file. If you supply a name, 
the map file appears in your current UFD but is not printed on 
the line printer. 


In TKB format, apply the /CR switch to the .MAP filespec. 


/CODE: (arg[,s]) 


DATA SPACE 
EAE 

FPP 

PIC 


POSITION INDEPENDENT 


The /CODE qualifier specifies that the code for the task relies 
on certain hardware elements or employs certain techniques. See 
the RSX-11M/M-PLUS Task Builder Manual for more information. 


The DATA SPACE argument (RSX-LIM-PLUS only) specifie 


‘task employ user-mode I- and’ DESRBee rs In TKB. ee 


“JID switch. to the - TSK ‘filespec.. 


The EAE argument specifies that the task uses the Extended 
Arithmetic Element. This hardware is optional and may not be 
part of your system. In TKB format, apply the /EA switch to. the 
-TSK filespec. 


The FPP argument specifies that the task uses the Floating Point 
Processor. This hardware is optional and may not be part of your 
system. In TKB format, apply the /FP switch to the .TSK 
filespec. 


The PIC and POSITION INDEPENDENT arguments are identical and 
specify that the resident common or library being built is 
position-independent. In TKB format, apply the /PI switch to the 
-TSK or .STB filespec. 


If you wish to use more than one argument, enclose them in 
parentheses, separated by commas. 
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/COMPATIBLE 


Specifies that the task be built in compatibility mode. This 
means that memory-resident overlay segments are aligned on 
256-word boundaries for compatibility with other implementations 
of the mapping directives. Without this qualifier, overlay 
segments are aligned on 32-word boundaries. 


In TKB format, apply the /CM switch to the .TSK filespec. 
/DEBUG[:filespec] 


Specifies the inclusion of a debugging aid in the task image. A 
debugging aid permits you to interrupt the running of a task and 
inspect registers and other memory locations at various’ stages. 
If you give no filespec, the default is LBO:[1,1]ODT.OBJ, which 
is ODT, the On-line Debugging Tool, a DIGITAL-supplied utility. 
ODT is incorporated in the task you are building. ODT can be 
used only on tasks written in the MACRO-11 Assembly Language. 
See the IAS/RSX-11 ODT Reference Manual for further information. 


If you have a user-written debugger, name the file it is in when 
you use this qualifier. This file should be an object moduie. 


In TKB format, apply the /DA switch to the .TSK filespec if you 

wish to use ODT. If you wish to use a user-written debugger, 

apply the /DA switch to the input filespec naming the debugger. 
/ERROR_ LIMIT:n 


Directs the Task Builder to abort LINK after n diagnostics errors 
have been produced. 


In TKB format, apply the /XT:n switch to the .TSK filespec. 


é TNOLEXTERNAD.. 


Specifies that the task ne: built tat run with its header. out. Of 
apoels: RSX- LIM-PLUS. only. The default: is /EXTERNAL. 


tn TKB Barats goby the /XH awittah® to. the .TSK tibends! 

/ POSTMORTEM 
Requests a Postmortem Dump should the task be terminated 
abnormally. See the RSX-1L1M/M-PLUS Task Builder Manual for 
information on Postmortem Dumps. 
In TKB format, apply the /PM switch to the .TSK filespec. 

/FAST 
Specifies that the Fast Task Builder be used to build the task. 


The Fast Task Builder is considerably faster than the default 
Task Builder. 
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Several restrictions apply to tasks to be built by the Fast Task 
Builder: . 


e Tasks may not be overlaid. 

e Tasks may not be privileged. 

e Tasks may not link to resident libraries. 

e The Task Builder cannot produce an .STB output file. 

e The Task Builder cannot create resident libraries. 

e The LINK command is limited to the following qualifiers: 
- /CROSS REFERENCE, /MAP, /LONG, /WIDE 


/ [NO] CHECKPOINT: SYSTEM 


/{NO]MEMORY MANAGEMENT 


/CODE: FPP 


/DEBUG[:filespec] 


e The Task Builder is limited to the following options: 

- ASG 

- STACK 

- UNITS 

- EXTSCT 

- ACTFIL 

- MAXBUF 
In addition, the map format is nonstandard and undocumented. 
You can also invoke the Fast Task Builder from DCL with the 
command RUN SFTB. You must follow TKB format if you run the Fast 
Task Builder in this fashion. 
See the RSX-11M/M-PLUS Task Builder Manual for more details. 

/FULL_SEARCH 

Specifies that when processing modules from the default object 
module library, the Task Builder should search all co-tree 
(overlay) segments for matching definitions or references. 
Without this qualifier, unintended global references between 
co-tree overlay segments are eliminated. Definitions of global 
symbols from the default library are restricted in scope to 


references in the main root and the current tree. 


in TKB format, apply the /FU switch to the .TSK filespec. 
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/ LONG 


/MAP [ 


/{NO] 


Specifies that the map file produced by the Task Builder include 
additional file information on modules used in the task build. 
The long map does not include file information on modules’ from 
the system library. 


If you include this qualifier, you automatically include the /MAP 
qualifier as well. You do not need the /MAP qualifier unless you 
wish to supply a name for the map file. If you supply a name, 
the map file appears in your current UFD but is not printed on 
the line printer. 


In TKB format, apply the /-SH switch to the .MAP filespec. 
:filespec] 


Specifies that you wish a memory allocation, or map, file 
produced. If you use /MAP as a command qualifier, without a 
filespec argument, the map appears in your UFD with a file name 
derived from the name of the first input file named in the 
command line and a file type of .MAP. The map is also printed on 
the line printer. 


If you use /MAP with a filespec argument, either as a command 
qualifier or a filespec qualifier, the map appears in your UFD 
with a file name you have given. The map is not printed on the 
line printer. 


If you use /MAP as a filespec qualifier, without a filespec 
argument, the map appears in your UFD with a file name derived 
from the name of the .OBJ or .OLB file to which the qualifier was 
attached. The map is not printed on the line printer. 


The following qualifiers automatically direct the Task Builder to 
produce a map with special characteristics: 


/CROSS REFERENCE 

/ LONG 

/SYSTEM LIBRARY DISPLAY 
/WIDE ~— a 


You do not need the /MAP qualifier with these qualifiers unless 
you wish to add a filespec argument to /MAP. These other 
map-related qualifiers can be used as either command or filespec 
qualifiers, but they have no effect on file names. 


In TKB format, the /MAP qualifier corresponds to the second 
position in the list of TKB output files and has the default file 
type .MAP. 


HEADER 

/NOHEADER sets the Task Builder STACK option to 0. If you are 
building a shared region or a driver, you should specify this 
qualifier. If you specify this qualifier, you may not use the 
STACK option. The default is /HEADER. 


itch to either the .TSK or  .STB 
option. See /SHARFABLE. 
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/{NO]IO PAGE 


/NOIO PAGE indicates to the Task Builder that the task is over 
12K and purposely does not map to the I/O page. This qualifier 
is for building privileged tasks only. The default is /IO PAGE. 


/ {NO]MEMORY_ MANAGEMENT [:n] 


Specifies that the task is being built for a system with (or 
without) memory management hardware. Use the 
/NOMEMORY MANAGEMENT qualifier when you are building a task on a 
system with memory management to be run on an RSX-11M (or 
RSX-11S) system without the Memory Management hardware. n 
specifies the highest physical address of a task on the target 
system and can be 28 (the default) or 30. 


The default is /MEMORY_ MANAGEMENT. 
In TKB format, apply the /-MM switch to the .TSK filespec. 
/SHAREABLE[:arg] 
COMMON 


LIBRARY 
TASK 


RSX-11M/M-PLUS. 


/SHAREABLE:COMMON informs the Task Builder that a shareable 
common is being built. You should always use the /NOHEADER 
qualifier with /SHAREABLE:COMMON. If you do not specify CODE:PIC 
or CODE:POSITION INDEPENDENT, TKB builds an absolute shared 
common. All program sections in the common are marked absolute. 
If you specify CODE:PIC or CODE:POSITION INDEPENDENT, all program 
sections in the common are marked relocatable. In either case, 
the .STB file contains all the program section names, attributes, 
lengths, and symbols. The .STB file of a common built /SHAREABLE 
contains all defined program sections. In TKB format, apply the 
/CO switch to the .TSK or .STB filespec. On RSX-11M-PLUS 
systems, /SHAREABLE:TASK defaults to /SEGREGATE. 


/SHAREABLE: LIBRARY informs the Task Builder that a_e shareable 
library is being built. You should always use /NOHEADER with 
/SHAREABLE: LIBRARY. TKB includes only one program section in the 
-STB file. If you do not specify CODE:PIC or 
CODE: POSITION INDEPENDENT, TKB names the program section .ABS, 
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makes the library position-dependent, and defines all symbols as 
absolute. If you specify CODE:PIC or CODE:POSITION INDEPENDENT, 
TKB gives the program section the same name as the root segment 
of the library. TKB forces this name to be the first and only 
declared program section in the library. MTKB declares all global 
symbols in the .STB file relative to that program section. In 
TKB format, apply the /LI switch to the .TSK or .STB filespec. 


/OPTION[:optionsspec] 


Specifies one or more Task Builder options. Use this qualifier 
if you need to use any of the Task Builder options. Information 
on these options is summarized in Table 6-3. See Section 6.4.1 
for information on using this qualifier. For full information, 
or options, see the RSX-11M/M-PLUS Task Builder Manual. 


You can supply options for this qualifier in two ways: you can 
supply the filespec of a file containing the options, or you can 
specify the options themselves. If you do not include a filespec 
with this qualifier, you are prompted for options. If you wish 
to enter multiple options, you must use a comma after each option 
listed. If you wish to list multiple options on individual 
lines, you must end each line with a comma. 


If you include a filespec with this qualifier, this file should 
contain only the option names, comments, and the arguments 
associated with the options, as shown: 


tINTTS=8 

ASG=TT0:7:8 

; COMMENTS, PRECEDED BY SEMICOLON, ALLOWED 
PAR=KROBAR: 50000: 40000 


This file should not include anything but the option statements 
and comments preceded by the semicolon (;). Comments preceded by 
the exclamation point (!) are not accepted in this instance. Do 
not put any slashes in this file. 


Note that the ABORT option is the only means of preventing a task 
build once you have begun issuing commands to the Task Builder. 
A CTRL/Z simply directs the Task Builder to begin the task build 
based on whatever instructions you have issued up to that point. 
Thus, if you want to be sure of being able to stop a task build 
in this way, you must include the /OPTIONS qualifier in the LINK 
command line. This assures the availability of the ABORT option. 
If you are typing the command line and make a mistake, specify 
the /OPTIONS qualifier, press RETURN, and enter the ABORT=0 
option. Then press RETURN and the task build aborts. 


/ OVERLAY DESCRIPTION 


Specifies that the input file is an overlay description file 
(type .ODL) that controls the linking of the task. No other 
input file can be specified if you use this qualifier. The .ODL 
file specifies input files to LINK. /OVERLAY DESCRIPTION can be 
either a command qualifier or a filespec qualifier. 


In TKB format, use the .ODL file as the only input file to the 
right of the equal sian (=) with the /MP switch applied to the 
ODL filesnec 


eae ae _ Ne 
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/PRIVILEGED[:n] 


Indicates that task is privileged. The argument n specifies the 
base relocation register. Acceptable values are 0, 4, or 5. The 
default is 5. 


In TKB format, apply the /PR switch to the .TSK filespec. 
/ [NO] RECEIVE 


Indicates that the task may (or may not) receive messages by 
means of the Executive directive SEND. /RECEIVE is the default. 


In TKB format, apply the /SE switch to the .TSK filespec. 
/([NO]RESIDENT OVERLAY 


Enables (or disables) recognition of the memory-resident overlay 
operator (!) in an overlay description file. The qualifier is 
used with the /OVERLAY DESCRIPTION qualifier when the task has 
memory-resident overlays. The default is /RESIDENT OVERLAY. 


In TKB format, apply the /RO switch to the .TSK filespec. 
/SAVE 


The /SAVE qualifier specifies that you wish to retain the 
indirect command file created by DCL to pass your LINK command to 
TKB. See Section 6.4.1 for a description of DCL's handling of 
the LINK command. Tf you include /SAVE in your LINK command 
line, a file named ATLNK.TMP appears in your UFD after the task 
build completes. Since this file always has the same name, you 
should give it a name related to the task it builds, such as 
SHEMPBLD.CMD. Then you can issue a command in the form 


yLINK @SHEMFBL Ii 


and duplicate the task build that originally produced the command 
File. , 


This file is also useful for comparing LINK command syntax with 
TKB syntax because it includes the full translation of the LINK 
command into TKB format. 


/ [NO] SEGREGATE 


/SEGREGATE causes the Task Builder to order program sections 
alphabetically by name within access code (RO followed by RW). 
If you also specify /SEQUENTIAL, TKB orders program sections in 
their input order by access code. 


/NOSEGREGATE is the default. TKB interleaves RO and RW _ program 
sections. When combined with /SEQUENTIAL, /NOSEGREGATE results 
in a task with program sections allocated in input order with its 
RW and RO sections interleaved. If you use /NOSEQUENTIAL and 
/NOSEGREGATE together, which is the default for both, TKB orders 
program sections alphabetically with RW and RO sections 
interleaved. 


In TKB format, use the /[-]SG switch on the .TSK filespec. 
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Table 6-3 


Task Builder Options 


Description and 
Language Key 


Direct TKB to terminate 
build (M,H) 


Declare task name (M,H) 


Set task's User Iden- 
tification Code (M,H#) 


Declare task's priority 
(M,H) 


Format and Defaults 2 


Control 


ABORT=0 
Number used for format only. Any 
number will do. 


Identification 


TASK=1-6 alphanumeric characters 
TASK=first six characters of first 
file name 


UIC=[{g,m] 
UIC=terminal UIC 


PRI=decimal integer 1-250 
PRI=set by INSTALL; 50, for 


nonprivileged users 


Declare task's partition 
name and size (M,H) 


PAR=parname[:base:length] 
PAR=GEN 


‘Declare the partition in 
which the read-only 

i if a multiuser 

is to reside (M, ") 


pect aice the completion _ 
routine the supervisor . 
10. library will use t 


ada in user mode (M,H 


1. Language key: 

M - Option is of interest to MACRO-11 programmers. 

H - Option is of interest to programmers using 
languages. 


high-level 


2. The first entry in the format and default column gives’ the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 
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Table 6-3 (Cont.) 
Task Builder Options 


Description and 


Language Keyl Format and Defaults 4 
Declare number of active ACTFIL=decimal integer 
files (H) ACTFIL=4 
Declare extension to MAXBUF=decimal integer for record 
FORTRAN record buffer (H)} Size in bytes (larger than 
default) 
MAXBUF=132. 
Declare extension of FMTBUF=decimal integer for number 
buffer used for process- in longest format description 
ing format strings (H) (larger than default) 
FMTBUF=132 
Declare extension of EXTSCT=psectname:extension 
program section (M,H) No default 
Declare extension of EXTTSK=decimal integer for increase 
task's portion of memory; in task memory allocation (in 
extends D-space of I- words) 
and D-space tasks Default from PAR option 
(M,H) 
Declare virtual base VSECT=psectname:base:window[:length] 
address and size of No default 


virtual program section ({H) 


Declare number of addi- WNDWS=0-5 

tional window blocks WNDWS=0 

needed by task (M,H) 

Declare size of stack STACK=decimal integer for number of 

(M,H) words needed for stack 
STACK=256. 


1. Language key: 

M - Option is of interest to MACRO-11 programmers. 

H - Option is of interest to programmers using high-level 
languages. 


2. The first entry in the format and default column gives’ the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. —~ 
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Table 6-3 (Cont.) 
Task Builder Options 


Description and 


Language Keyl Format and Defaults 2 


Sharing Storage 


Declare intention to COMMON=name:access-code[:apr] 
access system-owned No default 

common block for 

data in memory; if 

used with I- and 

D-space tasks, common 

mapped with D-space 

APRs only (M,H) 


Declare intention to LIBR=name:access-code[:apr] 
access system-owned No default 

resident library for 

code; if used with 

I- and D-space tasks, 

library mapped with 

I- and D-space APRs 

(M,H) 


Declare intention to RESCOM=filespec/access-code[:apr] 
access user-owned common; Standard defaults on filespec 

if used with I- and 

D-space tasks, common 

mapped with D-space APRs 

only (M,H) 


Declare intention to RESLIB=filespec/access-code[:apr] 
access user-owned library; Standard defaults on filespec 

if used with I- and 

D-space tasks, library 

mapped with I- and 

D-space APRs (M,H) 


1. Language key: 

M - Option is of interest to MACRO-11 programmers. 

H - Option is of interest to programmers using high-level 
languages. 


2. The first entry in the format and default column gives’ the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 
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Table 6-3 (Cont.) 
Task Builder Options 


Description and 


Language Key! Format and Defaults2 
Declare “intention to * 2. Became ans ie ete apr)” 
access’ a use wned . a defaul 
Superviso 
(M,H) : 
Allow task to dynamically CLSTR=libraryl,library2,...libraryn:switch: [apr] 
map memory-resident libraryl is default library 
shared regions at switch can be RW: or RO: 
run time. One task apr is starting APR 
address window maps No default 


the libraries into 
the same span of virtual 

address space. (M,H) 

Declare: intention. Ores svi: apr}: 
access ‘a. system-owned ©. iL 
supervisor. “mode | library 
(Spice oe ae 


Device 

Declare number of I/0 UNITS=decimal integer 0-250 
(logical) units (M,H) UNITS=6 
Declare logical device ASG=ddnn:unit-num:unit-num... 
assignment to units (M,H) ASG=SY0:1:2:3:4,T1I0:5,CLO:6 

Alterations 
Declare definition of GBLDEF:symbol-name:symbol-value 
global symbol (M) No default 


l. Language key: 

M - Option is of interest to MACRO-11 programmers. 

H - Option is of interest to programmers using high-level 
languages. 


2. The first entry in the format and default column gives’ the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 
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Table 6-3 (Cont.) 
Task Builder Options 


Description and 


Language Keyl Format and Defaults 2 
Declare global symbol GBLREF=symbol-name 
reference (M) No default 
Declare series of patch ABSPAT=seg-name:address:val-l .. . 
values; patches I-space (up to 8) 
of I- and D-space No default 
tasks (M) 
Declares series of patch DSPPAT=seg-name:address:val-l .. . 
values; patches D-space {up to 8) 
of I- and D-space tasks “No default 
(M) 
Declare series of patch GBLPAT=seg-name:sym-name[+/-offset]:val-l .. . 
values relative to global {up to 8) 
symbol (M) No default 
Exclude the specified GBLXCL=syml:sym2:...:sym8 
symbols from the symbol No default 


definition file of a 
supervisor mode library 


(M) 

Declare address and size ODTV=symbol-name:vector-length 

of ODT SST vector (M) No default 

Declare size of task SST TSKV=symbol-name:vector-length 

vector (M) No default 

Include specified symbols GLBINC=symbol-name,symbol-name,...,symbol-name 
in .STB file (M,H) No default 


1. Language key: 

M - Option is of interest to MACRO-11 programmers. 

H ~- Option is of interest to programmers using high-level 
languages. 


2. The first entry in the format and default column gives’ the 
format, the second entry gives the default, if any. This chart is 
only a reminder of the options, their formats, and their defaults. 
You must read the RSX-11M/M-PLUS Task Builder Manual for full 
information on these options. 
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/ SEQUENTIAL 


Directs Task Builder to construct a task image from program 
sections in the order in which they appear. Normally, the Task 
Builder finds all program sections referenced in all modules in 
an overlay segment and then builds the task with those program 
sections in alphabetical order. Do not use this qualifier to 
build tasks that rely on alphabetical allocation of program 
sections, such as FORTRAN I/O handling modules and FCS modules 
from SYSLIB. See also /SEGREGATE. 


In TKB format, apply the /SQ switch to the .TSK filespec. 


/ SLAVE 


Specifies that the task is to be slaved to a sending task. When 
a slaved task successfully executes the Executive directive 
Receive Data, it is given the UIC and TI: of the sending task. 
This qualifier applies only to systems with multiuser protection. 


Slaved tasks cannot be run with a RUN command. They must be run 
by the sending task. 


In TKB format, apply the /SL switch to the .TSK filespec. 
/ SLOW 


Invokes the Slow Task Builder. You should specify the Slow Task 
Builder only if your link or task build produces the following 
error message: 


NO VIRTUAL MEMORY STORAGE AVAILABLE 


The default Task Builder and the Fast Task Builder use a symbol 
table structure that can be searched quickly, but which requires 
more work file space than the Slow Task Builder. If you receive 
the error message shown, you have the choice of reducing 
work-file size as described in the Task Builder manual or of 
using the Slow Task Builder. 


Except for the use of different symbol table structures, the 
default Task Builder and the Slow Task Builder are identical. 
All qualifiers to LINK and all TKB options are available for the 
Slow Task Builder. 


You can also invoke the Slow Task Builder from DCL with the 
command RUN SSTK. You must follow TKB format if you run the Slow 
Task Builder in this fashion. 


/SYMBOL TABLE[:symboltablespec] 


Directs that a symbol table file be produced. The default name 
is that of the first input file and the default type is .STB. 
The filespec parameter overrides the defaults. This qualifier is 
used when building shared regions. 


In TKB format, this qualifier corresponds to the third position 
in the list of TKB output files, called the .STB filespec. 
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/(NO] SYSTEM LIBRARY DISPLAY 


Directs the Task Builder to produce a map that includes (or does 
not include) global symbols defined or referenced by the task. 
These symbols are found in LBO:[{1,1]SYSLIB or in any _ shared 
regions linked to using TKB- options. This map is usually 
considerably longer than the default map. The information 
displayed illuminates the contribution that SYSLIB or the shared 
regions make to the task. 


If you include this qualifier, you include the /MAP qualifier as 
well. You do not need the /MAP qualifier unless you wish to 
supply a name for the map file. If you supply a name, the map 
file appears in your current UFD but is not printed on the line 
printer. 


See the RSX-11M/M-PLUS Task Builder Manual for more information. 


In TKB format, apply the /MA switch to the .MAP filespec. 


/TASK[:taskspec] 
/®EXECUTABLE[:taskspec] 


Specifies a name for the task image file different from that of 
the first input file plus the type .TSK. If used as a filespec 
qualifier, the task name is derived from the name of the file to 
which the qualifier is attached. /EXECUTABLE is a synonym. 


In TKR format, this qualifier corresponds to the first position 


in the list of TKB output files, called the .TSK filespec. 


/NOTASK 
/NOEXECUTABLE 


/TKB 


Specifies that LINK produce no task image file. This qualifier 
is useful when you wish to use some facility of the Task Builder 
without building a task, to check for unresolved symbol 
references or make a map, for instance. /NOEXECUTABLE is a 
synonym. 


In TKB format, leave the first position in the list of TKB output 
filespecs blank, followed by a comma (,). 


Specifies that the default Task Builder be used to build the 
task. This is the default; the qualifier is included for 
completeness. 


You can also invoke the default Task Builder from DCL with the 
command RUN STKB. You must follow TKB format if you run the 
default Task Builder in this fashion. 


/ TRACE 


Specifies that the task is to be traceable. When you use this 
qualifier, a trace trap occurs on the completion of each 
instruction when the task is run. 


In TKB format, apply the /TR switch to the .TSK filespec. 
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/ (NO) WARNINGS 


/NOWARNINGS suppresses diagnostic messages issued by the the Task 
Builder. Two messages are suppressed: 


n undefined symbols segment "segname" 
and 
Module "modulename" multiply defines P-section "psectname" 
The default is /WARNINGS. 
In TKB format, use the /[-]NM switch on the .TSK filespec. 
/{NO]WIDE 


Specifies that the Task Builder map be printed in 132-column 
format. The default is /NOWIDE. 


If you include this qualifier, you include the /MAP qualifier as 
well. You do not need the /MAP qualifier unless you wish to 
supply a name for the map file. If you supply a name, the map 
file appears in your current UFD but is not printed on the line 
printer. 


In TKB format, apply the /WI switch to the .MAP filespec. 
Parameter Qualifiers 


Any input file can have a parameter qualifier applied to it, 
identifying the kind of file that it is. 


/ [NO] CONCATENATE 


Identifies the input file as a concatenated object file; this is 
the default. All modules in the file are processed to form the 
task image. /NOCONCATENATE specifies that only the first object 
module encountered is to be processed, regardless of how many are 
present. 


In TKB format, apply the /CC switch to an input file containing 
concatenated object modules. 


/LIBRARY 


Identifies the file as an object module library. This qualifier 
is required for any input library file and is prohibited for any 
other type of file. The default file type for object libraries 
is .OLB. 


The Task Builder searches the library file to resolve all 
undefined global symbol references from files appearing to the 
left of the library file in the LINK command line. The Task 
Builder then extracts any and all modules that resolve undefined 
references and includes them in the task image. See also 
/ INCLUDE. 
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/INCLUDE:modulel[:...modulen] 


You can specify as many as eight module names from a library 
using /INCLUDE. You must specify at least one. If you use the 
optional module arguments, the Task Builder takes only those 
modules from the library. The module names are defined at 
assembly time. 


If you wish both to resolve undefined references to global 
symbols and to specify modules, you must use this qualifier 
twice. 


In TKB format, apply the /LB switch to an input library file for 
both /LIBRARY and /INCLUDE. 


/DEFAULT LIBRARY 


Specifies that the file to which it is appended replace the 
system object module library, LBO:[{1,1]SYSLIB.OLB, as the default 
library that is searched to resolve unresolved global references. 
This qualifier can be applied to only one file and that file must 
be an object module library, type .OLB. 


In TKB format, apply the /DL switch to an input library file. 
/ [NO] GLOBALS 


Specifies that global symbols referenced and defined by the input 
file are (or are not) to be included in the map output file. The 
default is /GLOBALS. 


In TKB format, apply the /-MA switch to the input file. 
/SELECTIVE SEARCH 


Instructs the Task Builder to search the file only for undefined 
references to global symbols. This qualifier is most useful when 
building an Ancillary Control Processor or other privileged task 
that maps into the Executive. If you do not specify this 
qualifier, all tne Executive's gliobal symbol definitions are 
included in the task build, whether there are undefined 
references to the global symbol or not. The Executive contains a 
myriad of modules. In these and similar circumstances, this 
qualifier considerably shortens the symbol table search and 
improves system performance. 


If you do not use this qualifier, all global symbols from _ the 
input file are included in the task image. 


In TKB format, apply the /-SS switch to an input file. 
Examples 
~LINK 
File(s)? WRAY 


This example task builds the object file WRAY.OBJ into the task 
image file WRAY.TSK. For the LINK command to work properly, 
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WRAY.OBJ must be an object file. Since the user did not specify 
a file type for the object file, the LINK command supplied the 
default file type .OBJ. 


The return of the implicit prompt indicates successful completion 
of the task build. 


*LINK WRAY 


This example is equivalent to the previous one. 


SLINK/MAP WRAY 


This example is similar to the previous two except that a Task 
Builder map is also requested. When the task build is completed, 
the map WRAY.MAP is printed on the line printer and also appears 
in your directory. 


SLINK/MAPINEWLINK WRAY 


This example is similar to the previous one, except that a 
filespec is provided with the /MAP qualifier. When the task 
build is completed, the map file NEWLINK.MAP appears in your UFD. 
If you want a copy of this file, issue a PRINT command. 


“LINK WRAY/MAF 


This example illustrates another way of using the /MAP qualifier. 
In this case, when the Task Builder exits, a file called WRAP.MAP 
appears in your UFD but is not printed on the line printer. If 
you want a copy of this file, issue a PRINT command. 


“LINK/DEBRUG WRAY 


This example builds the task WRAY.TSK including ODT, the On-line 
Debugging Tool. 


*LINK/OF TIONS WRAY @ET 
Ortion?UNITS#8 
Oetiom?PASG=TT0I778 
Qetion? (QE 


This example illustrates the use of the /OPTIONS qualifier. The 
command sequence builds the task with eight logical units (LUNs), 
with LUNs 7 and 8 assigned to fTTO:. See the discussion in 
Section 6.4.1. The entire LINK command is entered by the final 
RETURN in response to the Option? prompt. 
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SLINK/OFTIONS/NOMEMORY_MAN WRAY 
Ortion?PAR=KROBAR i S000G6240000 


This example builds the task to run on an unmapped system in the 
partition named KROBAR, which has a base address of 50000 and a 
size of 40000. 


ZLINK/CHECKPOINTI SYSTEM WRAY 
>LINK/CHECKFOINT WRAY 


The commands in this example are equivalent. The task is built 
checkpointable to the system checkpoint file. 


SLINK/CHECKFOINTS TASK WRAY 


In this example, the task is built with checkpoint space reserved 
where the task image file is stored. 


SLINK WRAY: STRACK 


In this example, the task is built from two object modules, 
WRAY.OBJ and 3TRACK.OBJ. The task image file has the name 
WRAY.TSK. It is installed and run under that name. 


SLINK/TASK SHACK WRAY: STRACK 


In this example the task is built from the same two object 
modules as in the previous example. However, the task image file 
is given the name SHACK.TSK by the /TASK qualifier. It is 
installed and run under that name. 


SPLINK/OFTIONS WRAY: 3TRACK 
Ortion?TASK=SHACK 


In this example, the task is built from two object modules. The 
task image file has the name WRAY.TSK, but the default task name 
(specified by the TASK option) is SHACK. The default task name 
is used by the INSTALL command (see Section 7.8) if the user does 
not specify a task name explicitly. Only privileged users’ can 
issue the INSTALL command. This means that to run the task from 
a file, you use the command RUN WRAN, but if you run it after it 
has been installed, you use the command RUN SHACK. 


“LINK/OVERLAY RAYMEN 


In this example, the Task Builder uses the file RAYMEN.ODL to 
build an overlaid task. (.ODL is the default file type for the 
/OVERLAY qualifier.) The input file RAYMEN.ODL must be written in 
the Overlay Description Language. Only one file can be specified 
with this qualifier. The files that form the overlaid task are 
called automatically. 
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LINK @WRAYELE 


This example specifies the indirect command file WRAYBLD.CMD as 
input to the Task Builder. This file must be written in Task 
Builder format, not DCL format. This file can be the ATLNK.TMP 
file renamed. See the discussion under /SAVED. 


Notes 


You must read the appropriate documentation to use this command 
fully. This is true without exception. 


The RSX-11M/M-PLUS Task Builder Manual does not use the term 
"link." In the Task Builder manual, the preferred term is 
"build." 


Note that nonprivileged users can build privileged tasks and 
high-priority tasks, but those users cannot run the privileged 
tasks. Nor can they run tasks at any but the default priority of 
50. 


Remember that for nonprivileged users, the RUN command is always 
a combination of three commands. In effect, it is an 
INSTALL-RUN-REMOVE command. Thus, references to installation in 
the preceding discussion refer to explicit installation by 
privileged users through the INSTALL command = and implicit 
installation through the RUN command as well. See Chapter 7 for 
further details. 


You can include comments in the LINK command line in the usual 
DCL fashion. However, comments ina list of TKB options must 
appear on a line by themselves preceded by a semicolon. Do not 
use the exclamation point (!) for comments in a list of options. 
Error Message 
LIN -- Library invalid on last input file 
Explanation: The syntax of LINK requires that the last input 
file specified must be a valid (single) object file that is not 


part of a library. 


User Action: Check for proper syntax and reenter the command. 


6.4.3 LINK/C81 


This section explains how you can link COBOL-81 object files to 
produce a task image (.TSK file). 


Format 
LINK/C81[/qualifier[s]] filespec[,s] 


LINK/COBOL[/qualifier[s]] filespec[,s] 
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Command Qualifiers 


Although the format shows them as command qualifiers, you can 
append the following qualifiers to either the command or a file 
specification. When you use the LINK/C81 command, the two 
locations are equivalent. 


/ [NO] FMS 

/EMS: NORESIDENT 
/OTS: [NO] RESIDENT 
/{NO] RMS: [NO] RESIDENT 
/ (NO]MAP 

/ {NO] DEBUG 


Parameter 
filespec[,s] 


Specifies the file or files to be linked. The default file type 
is .SKL. 


The LINK/C81 command links object modules indirectly through 
their associated .SKL files. Therefore, if you include file 
types in any file specifications, you must use .SKL rather than 
-OBJ. Each .SKL file corresponds to an object module (.OBJ file) 
that is included in the task image. Except for the file type, 
the ~SKL file and object module have identical file 
specifications. 


You can list any number of .SKL files as input files in any 
order, separated by commas. 


Qualifiers 
/OTS: [NO] RESIDENT 


The /OTS:RESIDENT qualifier includes memory-resident OTS in your 
task image. When you specify /RMS:RESIDENT as well as 
/OTS: RESIDENT, LINK/C81 clusters these two libraries by default. 
If you can take advantage of the clustering feature, the 
resulting task image is smaller and program execution speed is 
improved. However, do not use /OTS:RESIDENT if memory-resident 
OTS is not installed on your system because an error condition 
will result. . 


The /OTS:NORESIDENT qualifier includes the disk-resident OTS 
library in your task image. 


The default is /OTS:NORESIDENT. 

/{NO] RMS: [NO] RESIDENT 
The /RMS:RESIDENT qualifier creates a reference to the shared 
RMS-11 memory-resident library, RMSRES. This library includes 


input/output support for sequential, indexed, and relative file 
organizations. 
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When you specify /OTS:RESIDENT as well as /RMS:RESIDENT, LINK/C81 
clusters these two libraries by default. If you can take 
advantage of the clustering feature, the resulting task image is 
smaller and program execution speed is improved. However, do not 
use the /RMS:RESIDENT qualifier if memory-resident RMS is not 
installed on your system because an error condition will result. 


The /RMS:NORESIDENT qualifier includes the disk-resident RMS 
overlays in your. task. By default, LINK/C81 provides’ the 
smallest RMS overlay structure available. This provides you with 
the smallest task image you can achieve using disk-resident RMS 
overlays. 
The /NORMS qualifier is equivalent to /RMS:NORESIDENT. 

/ {NO] MAP 


The /MAP qualifier causes LINK/C81 to produce a Task Builder map 
file with the file type .MAP. 


The /NOMAP qualifier tells LINK/C81 not to produce a memory map 
file. 


The default is /NOMAP. 
/ [NO] DEBUG 


The /DEBUG qualifier tells LINK/C81 to include the COBOL-81 
Symbolic Debugger in your task image. 


To use this qualifier, you must also use the /DEBUG qualifier to 
the COBOL command (see Section 6.2.4.1). 


The /NODEBUG qualifier tells LINK/C81 not to include the COBOL-81 
Symbolic Debugger in your task image. 


The default is /NODEBUG. 


/ [NO] FMS 
/FMS:NORESIDENT 


The /FMS qualifier causes LINK/C81 to include Forms Management 
Services (FMS) library support in your task image. You must use 
this qualifier if you call FMS routines from your program. 


The /NOFMS qualifier tells LINK/C81 not to include FMS support. 
The default is /NOFMS. 

The /FMS:NORESIDENT qualifier causes LINK/C81 to include support 
for a non-memory-resident FMS library in your task image. Since 


no resident FMS libraries are supported under RSX, this qualifier 
is equivalent to /FMS. 


For more detailed information about how to create a task image using 
LINK/C81, refer to the COBOL-81 RSX-11M/M-PLUS User's Guide. 
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6.6 SET AND SHOW 


You can set and show group global event flags. These are a set of 32 
global event flags available only to tasks run from one group of UICs. 
Otherwise, these flags are identical to other global event flags. 
Event flags are used for communication between tasks. See the 
RSX-LIM/M-PLUS Executive Reference Manual for further information. 


6.6.1 SET GROUPFLAGS 

SET GROUPFLAGS creates and deletes group global event flags. 
Privileged users can create and delete group global event -flags for 
any group. Nonprivileged users can create and delete global event 
flags for the group of which they are members. 


Format 


SET GROUPFLAGS[/qualifier] 
Flag? on 


SET GROUPFLAGS:n[/qualifier] 
Command Qualifiers 


/CREATE 
/DELETE 


Command Qualifiers 
/CREATE 


Specifies that you wish to create a set of group global event 
flags. This is the default and need not be specified. 


n is the group with which the flags are associated. 
Nonprivileged users can create and delete group global event 
flags for their own login group. Privileged users can create and 
delete group global event flags without restriction. 


/DELETE 


Specifies that you wish to delete a set of group global event 
flags. nis the group with which the flags are associated. 
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Example 
“SHOW GROUFFLAGS 
? 0 000000 
200 0 009000 
SET GROUFFLAG 
Flag? 303 
=SHOW GROUFFLAG 
7 0 000000 
200 0 0090000 
303 0 000000 


In this example, the user first displayed all the current group 
global event flags on the system and found that there were two 
sets but none for the user's group, which was 303. Then the user 
created a set of group global event flags for his group and 
verified their presence with the SHOW GROUPFLAGS command. 


6.6.2 SHOW GROUPFLAGS 


SHOW GROUPFLAGS displays the group global event flags currently in the 
system. 


Format 


SHOW GROUPFLAGS 


Example 
SHOW GROUFFLAGS 
7 1 000000 0000900 
200 1 000000 9000000 . 
201 1 000006 600000 
303 | 000000 000000 
$53 1 000000 000000 


This example shows the display from SHOW GROUPFLAGS. The first 
column is the group number with which the flags are associated. 
The second column is the access count. The two 6-digit numbers 
are the octal words that give the current state of each group 
global event flag. 


Group global event flags are flags 65 through 96. The first word 
starts at flag 80 and goes right to flag 65. The second word 
starts at flag 96 and goes right to flag 81. The final column is 
reserved for the delete flag DEL, which means the group global 
event flags are marked for delete and are not available. See 
Section 6.6.1. 


CHAPTER 7 


RUNNING TASKS 


The task is the fundamental executable programming unit. 

Tasks are built (linked) from one or more object modules. Tasks on 
RSX-11M/M-PLUS systems include tasks built from user programs as well 
as system tasks, such as compilers or utilities. 


Commands described in this chapter are used to initiate and terminate 
execution of tasks and to display the status of tasks. 


7.1 TASK INSTALLATION AND EXECUTION 


Tasks cannot execute unless they are installed in the_ system. The 
System Task Directory (STD), a data structure in the Executive's 
dynamic storage region (pool), is the list of installed tasks. Each 


installed task is identified by a Task Control Block (TCB) in the STD. 
You can display the contents of the STD with SHOW TASKS/INSTALLED. 
See Section 7.12.5. 


Nonprivileged users can install their own tasks through the RUN 
command. These tasks remain installed as long as they are executing, 
and are removed from the system when they finish. Privileged users 
can install tasks. These tasks can also be caused to execute with the 
RUN command. The tasks remain installed after execution. 


Many system tasks can be caused to execute with other commands. For 
instance, EDIT/EDT causes EDT, the DEC Editor, to execute on your 
terminal, and LINK causes the Task Builder to execute. 


Installed tasks are not necessarily resident in memory or competing 
for system resources. Most installed tasks are dormant, meaning they 
are installed but have not been requested to run. A dormant task uses 
little memory, yet it is immediately available when it is needed, such 
as to service a real-time event. 
Installed tasks can be in either of two states: 

Dormant Installed but not requested to run 


Active Installed and requested to run 


Tasks remain active until they abort, exit, or terminate in some other 
way. During this time, they can be in one of two substates: 


Ready-to-run Competing for CPU time on the basis of priority 
Blocked Unable to compete for CPU time either because a 
needed resource is not available, or for 


synchronization purposes, or through the STOP/BLOCK 
command (Section 7.12.4). 


Gags 
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You can display the list of active tasks with SHOW TASKS/ACTIVE. See 
Section 7.12.4. 


Tasks run at priorities of from 1 through 250, with 250 being’ the 
highest priority. The priority of a task can be established through 
the LINK, INSTALL, or RUN commands. Nonprivileged users are limited 
to priority 50 in the commands they issue, but if a privileged user 
has built or installed the task to run at a higher priority, then it 
will run at that priority for both privileged and nonprivileged users. 


Tasks can be built, installed, or run as checkpointable. 
Checkpointable tasks are liable to being checkpointed, or rolled out 
of memory to disks, in an incomplete state if a higher-priority task 
needs the memory space they are occupying. 


All memory is divided into partitions, which are subdivisions devoted 
to a particular task or tasks or to system functions. Partitions can 
be dedicated to a single task or shared by several tasks. If you do 
not specify a partition when you install and run a task, it will be 
installed in the default partition, named GEN. All partitions have a 
name and a size. 


Refer to the RSX-11M/M-PLUS Task Builder Manual for much more 
information on how tasks are built, installed, and run in partitions. 


7.1.1 Task Naming 


Tasks are installed under names from one through six Radix-50 
characters. The names identify the task in the STD. All commands and 
other operations affecting installed tasks require you to use the name 
of the installed task. 


Tasks acquire their instaiied names in a number of ways. 

Many task names include the number of the terminal from which the task 
was initiated. Terminal numbers are octal. Unless otherwise stated, 
all commands in examples in this section are assumed to have _ been 
issued from terminal TT10:. 

Tasks resulting from system commands are named after the command and 


the terminal from which the command was issued. Thus, the following 
command, issued from terminal TT10:; 


~SHOW TIME 
results in a task named SHOT10 in the STD while the task is executing. 


Likewise, the following batch command, issued” from virtual terminal 
vTas ‘ le 


- $SHOW TIME 


pequtea. in a task named SHOV4 i 
‘Batch processing is available on RSX~! 


D while the task is executing. 
M-PLUS only. dou 


And, the following command, passed through DECnet by host’ terminal 
number 6: 


SHOW TIME 


results in a task name SHOH6 while the task is executing. (A host 
terminal is a DECnet virtual terminal.) 
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For tasks that are installed and run explicitly, task names can be 
established through the LINK command, the INSTALL command, and the RUN 
command. 


If you begin with a source file named ROBOT.MAC and use the default 
LINK command after assembling the object file, you will end up with a 
task image file named ROBOT.TSK. You can install this task image in 
two wayS, through the privileged INSTALL command or through the 
nonprivileged RUN command. 


If you issue the privileged command 

SINSTALL ROBOT.TSK 
you will find the task name ROBOT in the STD. 
If you issue the command 

SRUN ROROT, TSK 
you will find the task name TT10 in the STD while the task is 
executing. The installation is through the install-run-remove form of 
RUN, which assigns a task name based on the name of the terminal from 
which the command was issued. 
You can override these defaults at every step. 
The TASK= option of LINK permits you to specify the name under which 
you wish the task image file you are creating to be installed. If you 
thus specify the installed name of ROBOT1.TSK to be EANDO when = you 
build the task, the privileged command 

2INSTALL ROBUTLI.TSE 
results in the task name EANDO in the STD. 
If, however, you issue the command 

>RUAM ROROTI. TSK 


you will again find the task name TT10 in the STD while the task is 
executing, despite the specification of EANDO at task build time. 


The command 
7RUN/STASK NAMESEANDO ROBOTL. TSK 
results in the task name EANDO in the STD while the task is executing. 


Since the RUN command defaults to a task name that is based on _ the 
terminal designation (without the colon), you must use the /TASK_NAME 
qualifier if you wish to use the RUN command to initiate execution of 
more than one task at atime from the same terminal. This is true 
because all task names in the STD are unique; you cannot have_ two 
tasks named TT10 installed at the same time, for example. See the 
examples in Section 7.2. 
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Finally, most DCL and MCR commands work by running tasks, although you 
do not have to issue a RUN command. The LINK command, for instance, 
runs the Task Builder. Such tasks are named after the first three 
letters of the command word, plus the terminal identifier. Thus, when 
you issue a command such as the following: 


SLINK RUMBLE 


the result is a task named LINT10. In fact, the RUN command itself 
results in the brief existence of a task named RUNT10O. 


If you are running a utility, using a command in the form 
SACK PLP 
your task will have a name of the form PIPT10. 


On RSX-11M systems only, there is’a possibility of a slight. variation’ 
in. the task-naming. “rules. If, when you. run.a utility, you are ‘the 
‘only user, using that: utility, - the - utility .is installed under its 
prototype name, which has a name. preceded by three dots, suchas” 
.+sPIP. Any Subsequent users run the utility under: a name in the form 
PIPT1O.. It..makes -no difference. to you whether you are running the 
prototype: or a copy... sige ta hn ee 


You never run the prototype on RSX-11M=-PLUS systems. 


See Section 7.2 for more information on including the dollar-sign (S$) 
in a RUN command. 


On RSX-11M-PLUS systems with more than 64 terminals, tasks run. from 
the higher-numbered terminals — ‘cannot be named directly after. their 
terminals because. of restrictions. on the number of characters in oa 
task ‘name. The following — discuss a ee the problem and its 
solution. ee Es 


Remember..that terminal numbers: are octal. © The first 64. terminals . on 
an RSX-11M-PLUS system are numbered 1 through 77 (octal). The system 
supports as many as 256 ermi p28 >arminals 65. through... 256. are 
numbered 100... through. 377 Tasks initiated .from.. these 
terminals. cannot be named di ectly. their terminals, because the 
task name is limited to six: characters and their numbers, if.used 
explicitly, are. too Large: for. task names. For example, SHOT107 is~ an 
illegal task name. ie Wee es ne Nioog See alee 


“Therefore, when the RUN Toamiaiia is tested. Foo ‘terminals. Spumbered: 100 
» through: :.377 (octal), a slightly different derivation of task names is 
employed” Assume your. terminal is PAD wi: The command: hoe : 


RUN ROBOT 


cbabereees” a “eaek. homed: TTAT. The letter A Stands oe: oebe ~ first: EWS. 
“digits of the unit number of the terminal, 10 in this case... To. 
minimize the confusion resulting: from this. convention, © the display 
“from SHOW TASKS/ACTIVE includes the name of the initiating terminal in. 
“parentheses next to. the name . RE the active PaEaSK ss Ene SHOW task. ~itsel£ 
WELT: be named" “SHOTAT7... Soap aE er : sos 
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‘The renumbering “sys 
with” ‘a singl 


Only uninstalled tasks initiated with he RUN connene have task names 
preceded by VT, TT, or HT. Tasks initiated by other DCL commands are 
named after the first three letters of the command that initiated the 
task, plus a T, V, or H (for physical, virtual, or DECnet host 
terminal) plus the unit number. 


7.2 INTRODUCTION TO THE RUN COMMAND 


RUN initiates the execution of a task. This command can be used in 
four ways: 


e To install, run, and remove upon execution a task from a task 
image file stored ina user's UFD. This is the most common 
use of the command. 


e To install, run, and remove after execution a task from a task 
image file stored in the system UFD, or» library UFD’on 
RSX-lLIM-PLUS systems. 


e To run immediately a task previously installed by a privileged 
user 


e To run at some future time, or according to a schedule, a task 
previously installed by a privileged user 


These functions are introduced in more detail in the following 
sections. 
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RUN (Cont.) 


The first and most common use of RUN is to initiate execution of tasks 
contained in task image files. The command 


oRUN FPUFFET. TSK 


directs the operating system to look in the default UFD on the default 
device for a task image file named PUPPET.TSK. When the file is 
found, the image is read in to memory and execution commences. When 
the task has executed, the image is removed from memory and from the 
STD. 


Whenever a RUN command includes any element of a file specification, 
this procedure is followed. The command 


7 RUN DROS MUPPET 


directs the operating system to look in the default directory on 
device DBO: for a file named MUPPET.TSK and install it, run it, and 
remove it when it has completed execution. The default file type in 
this case is .TSK, which is also the default file type for a task 
image file created by the Task Builder. 


The second use of RUN is es initiate execution of tasks contained in 
task image files in “system UFD (on RSX-11M), or -the system and. 
library UFDs (on RSX-1IN-PLUS) The dollar sign ($) in a filespec 
indicates that you wish to use this form of RUN. The purpose of this 
convention is to relieve you of the necessity of knowing exactly where 
on the system various system tasks are stored. Simply include the $ 
in your RUN command and the system takes over. If you receive the 
error message 


RUN -- File not found 
or 
INS -- File not found 


your system manager has chosen not to include that particular task or 
utility in one of these UFDs, perhaps to conserve disk space. In this 
case, see your system manager. 


In general, you can use the $ to run most system tasks and utilities. 
These usually have three-letter names like PIP or TKB, but the RMS-11 
utilities have six-letter names like RMSDSP or RMSCNV. See the RMS-11 
documentation supplied with your system for more information on 
RMS-11. (Your system manager may also have added other task image 
files not supplied by DIGITAL to these directories for your 
convenience.) 


On. RSX-11M systems, copies of many. or all system tasks are. placed: in 
the system UFD on pseudo: device LB:. The directory is usually [1,54], 
but it can be some other number. You can display the identity. of this 
directory with, the command SHOW SYSTEM/DIRECTORY.:. You can list the 
contents of the directory with a - DIRECTORY: command. vi Prategicher td 


On RSX-11M-PLUS systems, copies of: many or all> privileged system tasks 


‘are -placed..in the ‘system UFD on ‘pseudo device LB:.°. The directory is 
usually tle S41 ¢ but. it can be some other number... You can display... the 
dentrr: “ehes.” directory with the command SHOW. ‘SYSTEM/DIRECTORY. 


you ean li st the contents of the directory with a DIRECTORY command. . 
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In addition, on RSX-11M-PLUS: .systems, copies of many. all 
nonprivileged. system tasks are. “placed in the library. UFD. on a eecads 
device LB:. The directory is usually [32 54), but it can be some: other 
numbér. You can display © the identity of this directory with’ the. 
‘command. SHOW. LIBRARY /DIRECTORY. “You can” also” list. the- COntenes. of ‘the 
directory with a DIRECTORY command. see ean pe ae Ne tet i ee Ae ENE ab, pea 


The system responds to the $ in a filespec as follows. The command 
>RUN €TKE 


directs the operating system to look for a file called TKB.TSK and to 
install, run, and remove it when it has completed execution. Since 
the Task Builder is a privileged task, it will be found in the system 
UFD on either RSX-11M or RSX-11M-PLUS. The system installs, runs, and 
removes TKB just like any other task. 


On RSX-LIM-PLUS, if. ‘the com 
as-.in | the: following ¢ omman: 


ind: had nam HeRREIGE des © otaske 2such 


ee id 


>RUN SP IF 


a isyetem ‘UPD, are ‘failing 
O. EE: HAE REY MEDS ‘to. Sea keh: 


ene. Syston, wouls: still sta 
to find: PIP.TSK there, wou: 
for. PIP.TSK there... sig 


NOTE 


Privileged users can aiso use the dollar 
Sign ($) with the INSTALL command. See 
Section 7.8. 


The third use of RUN is to execute immediately a previously installed 
task. The task must have been installed by a privileged user. The 
command 


* RUN TURTLE 


directs the operating system to look in the list of installed tasks 
(STD) for a task named TURTLE. Once the system has found the task 
TURTLE in the STD, the task commences its execution. The task need 
not be installed since it is already installed, nor is it removed when 
it has completed its execution. The task runs under the name TURTLE, 
not TT10. 


(If the system does not find an installed task of the name you give, 
the command defaults to the instali-run-remove form and looks in the 
default UFD on the default device for a file named TURTLE.TSK, and 
continues as described earlier.) 


Finally, privileged users can use RUN to schedule the execution of a 
task in several forms. Scheduling options include: 


e Run the installed task after so many hours, minutes, seconds, 
or ticks. 


e Run the installed task at an absolute time of day. 


RUNNING TASKS 
RUN (Cont.) 


e Run the installed task in synchronization with the next hour, 
minute, second, or tick, that is, at the beginning of the next 
interval. 


e Run the installed task at regular intervals. 
In addition, these scheduling options can be combined. 


RUN as used to install, run, and remove tasks contained in task image 
files is described in Section 7.2.1. RUN as used with previously 
installed tasks is described in Section 7.2.2. 


7.2.1 Running Tasks Contained in Task Image Files 


When used to run an uninstalled task, RUN is actually a combination 
command, encompassing INSTALL, RUN, and REMOVE. This command is the 
only way a nonprivileged user can install or remove a task. 


Format 


RUN[(/qualifier[s] ] 
Task? [$]filespec 


RUN[/qualifier[s]] [$]filespec 
Command Qualifiers 


/ [NO] CHECKPOINT 
/COMMAND:"taskcommand" 
/ [NO] POSTMORTEM 
/EXTENSION:n 
/PARTITION: parname 
/PRIORITY:n 
/STATUS:arg 

TASK 

COMMAND 
/TASK NAME: taskname 
/TIME LIMIT:n[u] 
/UIC:[g,m] 


Parameter 

($]filespec 
Specifies a task image file on a mounted Files-1l volume. This 
task is installed, run, and then removed when it has finished 
executing. 
The default file type is .TSK. See Notes. 
The dollar sign ($) directs the system to search first for the 
file in the system UFD and, on RSX-11M-PLUS systems, also in the 
library UFD. In this case, the $ specifies a device and 
directory and thus counts as an element of a file specification. 


Command Qualifiers 


These qualifiers establish how the uninstalled task is to be 
installed. 
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/ [NO] CHECKPOINT 


Specifies whether or not the task is to be run checkpointable. 


The default is established when the task is built (linked). 
qualifier is used to override the default. 


This 


In other words, this qualifier allows you to run _ checkpointable 


tasks as noncheckpointable and vice versa. 
/COMMAND:"taskcommand" 


Use the /COMMAND qualifier to pass a command to the task you 


are 


running. The command must be inside the "quotes" and not more 


than 40 characters long. For example, the command 


>RUN/COMMAND:"/LI" SPIP 


runs PIP and then passes the /LI switch to it. This results in a 


directory listing. 
/ {NO] POSTMORTEM 


Specifies whether or not a Postmortem Dump is to be generated 
the task terminates unexpectedly. 


The default is determined when the task is built. If 
specified, the LINK command defaults to /NOPOSTMORTEM. See 
RSX-11M/M-PLUS Task Builder Manual for more information 
Postmortem Dumps. 

/EXTENSION:n 


Specifies that n additional decimal words of address space 
allocated to a task. 


/PARTITION: parname 


if 


not 
the 
on 


be 


Specifies the partition in which the task is to run. The default 
is established when the task is built (linked). This qualifier 


is used to override the default. 


If no partition is established at task build or with the 
command, the task will run in the default partition GEN. 


/PRIORITY:n 


Specifies at what priority the task is to run. This is 


RUN 


a 


privileged qualifier. The default is established when the task 


is built (linked). This qualifier is used to override 
default. 


the 


The default priority for the Task Builder, INSTALL, and RUN is 50 
(decimal). If a task has been built or installed at another 
priority, nonprivileged users can run it at that priority. 
Otherwise, nonprivileged users are limited to running tasks at 


the default priority. 


Priorities range from 1 through 250 (decimal). 


RUNNING TASKS 
RUN (Cont.) 


/STATUS:arg 
TASK 
COMMAND 


Specifies whether exit status is to be returned from the RUN 
command or from the task being run with the RUN command. The 
default is /STATUS:COMMAND and need not be specified. 


The /STATUS: TASK qualifier may be necessary in user batch jobs 
that run installed tasks where the batch processor must wait for 
the installed task to exit before attempting to execute the next 
command. 


/TASK_NAME: taskname 


Specifies the name under which the task is to be run. The 
default is to run the task under a name derived from the name of 
the terminal from which the RUN command was issued, as discussed 
in Section 7.1.1. 


Use this qualifier when you wish to run two tasks simultaneously 
using the RUN command. Otherwise, the second RUN command causes 
the following error message to appear on your terminal: 


RUN -- Task name already in use 
See the examples. 


Task names are restricted to six Radix-50 characters. The 
Radix-50 character set consists of the 26 uppercase letters, the 
10 numerals, and the period (.) and dollar sign ($). 


/TIME LIMIT: n{u] 


This RSX-1LIM-PLUS qualifier allows you to limit the amount of CPU 
time the task can run. The default is /TIME LIMIT:3M. The "M" 
stands for minutes. If you give simply a number as an. argument, 
the time unit defaults. to minutes, but you can also specify a 
time limit in seconds by using a number and an §"S", as in 
/TIME..LIMIT:308. 


/UIC:[g,m] 
Specifies the default UIC for the task. This is ae privileged 
qualifier. This UIC determines in what protection class the task 
belongs, and thus determines file access. 
The square brackets are required syntax. 


Examples 


“RUN 
Task? ROBOT 


This example installs, runs, and removes upon completion of 
execution the task contained in the task image fiie named 
ROBOT.TSK from the default UFD on the default device. 


RUNNING TASKS 


RUN (Cont.) 


“RUN ROBOT. TSK 


The two commands in this example are the equivalent of the 
command in the previous example. 


The following examples illustrate the task-naming convention. 
See Section 7.1.1 for more information on task naming. 


On: RSX- LIM: PURE SUe. the ‘termi 


“convention aso aes a. ern 
er than 77° toctabn te this: SARE. TEEO 
to. othe: SHOW. task. oe : 


“RUN/TASKONAMEF CAPER FORO 


-SHOW tae eee 
MGRe ss : 
SHOT16 
CAPER 


oe 


This example shows how the task-naming convention can be 
overridden for the RUN command by running the task under another 
name using the /TASK_NAME qualifier. 


“RUN ROBOT 
“SHOW TASKS/ACTIVE 
MCRess 
SHOT16 

TT1G 

“RUN ASIMOV 
RUN -- Task mame slready in wse 
“RUN/TASKIBINUER ASIMOY 

“SHOW TASKS /ACTIVE 


MCRaes CTTLO?) 
SHOT10: eee 
TT1i0 TP TOLD: 
BINDER (TT1O: 


This example shows how you can run two tasks simultaneously using 
the RUN command and the /TASK_NAME qualifier. 
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Notes 


The return of the implicit monitor prompt (>) signifies that the 
task initiated by the RUN command has exited. However, you need 
not wait for the prompt to return to issue another command. 
Simply enter a carriage return or CTRL/C and enter the command. 


This section describes RUN as it works with any portion of a file 
specification included. In general, you do not have to include 
the file type, as .TSK is the default. In one unusual 
circumstance, however, you must explicitly enter a file type. If 
there is a task already installed in the system that has the same 
task name as the file name of the task image file containing the 
task you wish to run, the RUN command will run the installed task 
rather than the one you wish to run. In such an instance, you 
must include the file type to force the RUN command to access the 
task image file. 


Some error messages resulting from RUN are labeled INS rather 
than RUN because this form of RUN installs the task automatically 
and the error occurs during the installation. 


7.2.2 Running and Scheduling Installed Tasks 


RUN also initiates the execution of installed tasks. Privileged users 
can use RUN to initiate the execution of installed tasks on a schedule 
by creating entries in the system clock queue. 


Tasks that run as a result of entries in the clock queue run with 
pseudo device COO: as their TI:. For this reason, these commands are 
privileged. Such tasks send output to CO0: and not to the terminal 
they were run from. 


Format 


RUN[/qualifier[s] ] 
Task? taskname 


RUN[/qualifier[s]] taskname 
Command Qualifiers 


/DELAY:nu 
/INTERVAL:nu 
/SCHEDULE:hh:mm:ss 
/STATUS: COMMAND 
TASK 
/SYNCHRONIZE:u 
/UIC:[g,m] 


Parameter 
taskname 


Specifies the name of the installed task to be run. The names of 
installed tasks are one through six Radix-50 characters. 
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If the System Task Directory (STD) contains no entry under the 
task name you supply, the system searches the default directory 
on the default device for a file named taskname.TSK. If RUN 
finds such a file, it installs, runs, and removes it. 


Command Qualifiers 


The time-oriented qualifiers to RUN create entries in the system 
clock queue. The contents of the clock queue can be displayed 
with the command SHOW CLOCK QUEUE. See Section 7.12.9. 


/ DELAY :nu 


Specifies that the task be run after the stated amount of time 
passes. This qualifier is privileged. The argument nu specifies 
the amount of the delay as a number of units. n is the number of 
units and u is the time unit as follows: 


T - Ticks 
S - Seconds 
M - Minutes 
H - Hours 


If your system has the standard line-frequency clock, the length 
of a tick depends on the line frequency of the electric power 
source serving your location. Most commonly, this frequency is 
60 Hz, which results in a tick length of 1/60th of a second. 


If your system has an optional programmable clock, the length of 
a tick depends on the choice made at system-generation time. See 
your system manager for more information. 
Acceptable values for these units are as follows: 

T - Any positive value to a maximum of 15 bits, or 32767. 

S ~ Any positive value to a maximum of 15 bits, or 32767. 


M The maximum value is 1440. 


The maximum value is 24, 


H 


The system always waits at least one interval. If you specify 0, 
the system treats it asa l. 


/INTERVAL: nu 


Specifies that the task is to be run at regular intervals. This 
qualifier is privileged. The argument nu specifies the interval 
as a number of units of time. n is the number of units, and u is 
the unit as follows: 


T - Ticks 
S - Seconds 
M - Minutes 
H - Hours 


See the /DELAY qualifier for a detailed description of these 
units. 
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/SCHEDULE:hh:mm:ss 


Specifies that the task be run at a particular time of day. This 
is a privileged qualifier. 


/STATUS: arg 
COMMAND 
TASK 


Specifies whether exit status is to be returned from the RUN 
command or from the installed task being run with the RUN 
command. This is not a privileged qualifier. The default is 
/STATUS:COMMAND and need not be specified. 


The /STATUS:TASK qualifier may be necessary in user batch jobs 
that run installed tasks where the batch processor must wait for 
the installed task to exit before attempting to execute the next 
command. See the examples using /STATUS:TASK. 


/SYNCHRONIZE:u 


Specifies that the execution of the task be synchronized on_ the 
next occurrence of a particular clock unit. This is a privileged 
qualifier. u is the time unit as follows: 


- Ticks 
Seconds 
Minutes 
- Hours 


mene 
J 


See the /DELAY qualifier for a detailed description of these 
units. 


/UIC:[g,m] 
Specifies the default UIC for the task. This is a privileged 
qualifier. The task's UIC determines what file-protection class 
it belongs in, and thus directly influences file access. 
The square brackets are required syntax. 
Examples 
>RUN/DELAY$5SS PINBAL 
This example initiates execution of the installed task PINBAL 
five seconds after the command is entered. 
*RUN/INTERVALS 20M WIZARD 
This example initiates execution of the installed task WIZARD 
immediately and every 20 minutes thereafter. 
>RUN/DELAY?1OM/INTERVALI 1H TOMMY 


This example initiates execution 


of the installed task TOMMY 
after ten minutes and every hour the Et 
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>RUN/SCHENULES 12700700 NOUN 


This example initiates execution of the installed task NOON at 
the next 12:00:00 after the command is entered. I£ you entered 
the command before noon today, NOON would run at noon today. it 
you entered the command after noon today, NOON would run at noon 
tomorrow. 


*RUN/SYNCHRONIZE?H BOGUS 


This example initiates execution of the installed task named 
BOGUS on the next hour. If you entered the command at 9:15, 
BOGUS would begin running at 10:00:00. 


>RUN/SYNCHRONIZESH/INTERYVAL IIH BELTOL 


This example initiates execution of the installed task named 
BELTOL every hour on the hour, starting with the next hour. 


SINSTALL SHIFI 
SRUN/STATUS: TASK HIFI 
SEOJ 


This example illustrates the use of the /STATUS:TASK qualifier in 
a user batch job. First the job installs the task HIFI from the 
library UFD. Then the task is- run, If the user had not 
included the /STATUS:TASK qualifier, the RUN command would have 
returned a status of success, the batch processor would have 
executed the EOJ, and the EOJ would have aborted the task that 
had just started running. With the qualifier, the EOJ is not 
executed until after the task has exited. See next example. 


SINSTALL CAVIAR 
SRUN/STATUS: TASK CAVIAR 
SPRINT/FLAG PAGE FISHEGGS.LST, SHADROE.LST 


This example also illustrates the use of the /STATUS:TASK 
qualifier in a user batch job. First the job installs the task 
CAVIAR. When run, this task writes two listing files, 
FISHEGGS.LST and SHADROE.LST. After these files have been 
written and closed, the batch job prints them both. With the 
/STATUS: TASK qualifier on the RUN command, the batch processor 
waits for the installed task CAVIAR to exit before attempting to 
print the files. Without the qualifier, the batch processor 
would attempt to print the files while they were still being 
written. 
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Notes 
The implicit prompt returns immediately after you issue a RUN 
command for an installed task and does not indicate that the task 
has completed its execution. 


You can display entries in the clock queue with SHOW CLOCK QUEUE, 
Section 7.12.9. 


The clock queue is kept in pool and must be restored whenever the 
system is rebooted. 


Error Message 
RUN -- Invalid time parameter 
Explanation: Command specified an invalid time argument. 


User Action: Check for proper syntax and reenter command. 


7.3 ABORT 


ABORT forces an orderly end to a running task or to the action of a 
specific command. 


Tasks can also be aborted by other tasks or by error-handling 
routines. If this happens, some of the messages discussed below can 
appear on your terminal without your having issued an ABORT command. 


Nonprivileged users can abort any task running on TI:. Privileged 
users can abort any task. 


Format 
ABORT[/COMMAND] [/qualifier[s]] commandname 
ABORT/TASK[/qualifier[{s]] [taskname] 
Command Qualifiers 
/COMMAND 
/ TASK 
/TERMINAL:ttnn: 
/ [NO] POSTMORTEM 


Parameters 


The parameters differ depending on whether you are aborting a 
command or a task. 


The default is to abort a command. See the examples. 

commandname 
Specifies the command whose effect you wish to cancel. This 
parameter can be used only when the /TASK qualifier is not 


present. You must specify at least the first three characters of 
the command verb. 
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taskname 


Specifies the name of the task you wish to abort. This parameter 
requires the presence of the /TASK qualifier. If you use the 
/TASK qualifier and do not specify a task name, you will get an 
error message, "Illegal task name." 


Command Qualifiers 
/COMMAND 


Specifies that you wish to abort a command. This is the default 
qualifier and need not be included. 


/ TASK 
Specifies that you wish to abort a task by name. 
/TERMINAL:ddnn: 


Specifies that a task from some terminal other than your own be 
aborted. This is a privileged qualifier for RSX~11M-PLUS only. 


/{NO] POSTMORTEM 


Specifies that a Postmortem Dump be taken (or not taken) of the 
task before it is aborted. See the RSX-11M/M-PLUS Task Builder 
Manual for more information. 


If the task is memory-resident, the contents of its registers are 
listed on the terminal. If it is checkpointed, no register 
contents are listed. 


You can specify a Postmortem Dump when you build a task or _ when 
you install it (including install-run-remove). The default for 
this qualifier is determined by previous specification of the 
/DUMP qualifier. If no /POSTMORTEM qualifier has been specified, 
the default is /NOPOSTMORTEM. 


Examples 


>ABO RUN 
Titiitil Task "TTid® terminated 
Aborted vis direstive OF CLI 


This example aborts a task initiated with the RUN command running 
on your terminal. See next example. 


>RUN TREK 
ORDERS: STAR DATE = 20600 
YOU MUST DESTROY THE KLINGON INVASION FORGES OF 29 BATTLE 
CRUISERS, YOU HAVE 40 SOLAR YEARS TO COMPLETE YOUR MISSIUN, 
READY? (€IRLC 
TNCLS>ABORT RUN 
1271109 Task "TTiO" terminated 
Aborted via directive or CLI 


In this example, the user instalied the interactive task TREK by 
means of a RUN command. Then, instead of providing the task with 
requested input, the user issued a CTRL/C to return to the DCL 


T17 


RUNNING TASKS 
ABORT (Cont.) 


monitor level and then issued the ABORT command. DCL prompted 
for the command to be aborted and RUN was specified. The task 
was aborted and removed, and the message displayed. The message 
mentions MCR because DCL does not actually perform the abort. 


2ABORT/TASK MACTS 
This example aborts the task named MACT3. Nonprivileged users 
can abort tasks running on their own terminals. Privileged users 


can abort tasks by name running on any terminal. See next 
example. 


~DIRECTORY *.RNO 


Ttirectors DROILSG2sS] 
2O-NOV-S32 16328 


ALTCLI.RNO?3 212. 27-AUG-382 146¢52 
ANNI.RNOF6 3: SO-JUL-S2 OF 730 
AFRCOM.RNO + 4 9. Lo-APR-G2 16.35 
REST.» RNO?FS 40. 28-AUG"-B2 15330 
CATCH,RNO?4 7s 22-MAY-B2 OF 34% 
CHAFLISNHG.RNO?13 43. LS-0GT See 10834 
CHAPI25SMG.RNOFS1 22S O8-OCT-S2 i3:315 
CHARSET.RNOs5 &s 15-JUR-S2 11:57 GRO 


TCL: ABORT DIRECTORY 
16129145 Task "DIRTS46" terminated 
foorted via directive or OLLI 


In this example, the user issued a DIRECTORY command and soon saw 
that the file he was checking for was present. Rather than wait 
for the directory listing to complete, the user typed CTRL/C and 
entered the ABORT command in response to the explicit DCL prompt. 
The ABORT command defaults to ABORT/COMMAND. 


SABORT/TERMINALI TTS: MACKO 


This example, issued by a privileged user, aborts the MACRO task 
running on another terminal. Notification of the abort appears 
on TT3: but not on the terminal from which the ABORT command was 
issued. RSX-11M-PLUS only. 


*ABORT/DUMF RUN 
1474111 Task "TT16 * terminated 
Aborted via directive or CLI 
RO=Q000060 
RL=100077 
R2=135606 
R3=O0006045 
R4=00000% 
RS=000000 
SFeOLE540 
PS=170017 


In this example, the user requested a Postmortem Dump. The 
contents of the task's registers at the time of the abort are 
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listed on the terminal along with notification of the dump. The 
dump file will be printed on the system's line printer. 


Notes 
A is the short form of ABORT. 


ABORT forces an orderly termination of a task. To effect the 
termination, the system performs four steps: 


e Alters the task's priority to 247. A task must be memory 
resident to be aborted. This step usually forces the 
quick return of a checkpointed task. 


e Performs I/O rundown: cancels I/O for nonfile-structured 
devices; completes I/0 for file-structured devices and 
deaccesses files; detaches all attached devices. 


e Executes the Task Termination Notification program 
(TKTN), which displays messages on the aborted task's 
a hal ae 


e Releases any memory allocated to the task if the task is 
not fixed. 


The TKTN routine can list a number of messages about the abort. 
These messages are explained below. 


LOGOUT also aborts nonprivileged tasks running Erom your 
terminal. 


Tasks can also be aborted by Executive directives issued by other 
tasks, in particular, by error-handling routines. 


TKTN Messages 
These messages appear as part of the notification of the abort. 
Often a list of register contents also is displayed. 
Understanding these messages requires an understanding of how the 
PDP-11 executes instructions. If you receive these messages and 
do not understand them, you should copy them, along with any 
other terminal output, and show them to your system manager. 

Aborted via directive or CLI 


Explanation: Either a CLI or an Executive directive issued by 
another task caused the task to be aborted. 


AST abort. Bad stack 


Explanation: An AST could not be effected because the AST 
parameters could not be pushed on the stack. 


Checkpoint failure. Read error 


Explanation: The task could not be read back into memory after 
being checkpointed. 
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IOT execution 


Explanation: The task executed an IOT instruction, and no _ SST 
routine was specified to process the trap. 


Load failure. Read error 


Explanation: The task could not be loaded because of a hardware 
error. 


Memory protect violation 


Explanation: The task encountered a memory-protect violation and 
no SST routine was specified to process the trap. 


Non RSX EMT execution 
Explanation: The task executed an EMT instruction with an 
argument other than 377 (octal) or, in the case of a privileged 
task switching to system state, 376 (octal), and no SST routine 
was specified to process the trap. 

Odd address or other trap four 
Explanation: The task executed a word instruction with an _ odd 
address, or it referenced a nonexistent memory location, and no 
SST routine was specified to process the trap. 

Parity error 
Explanation: A parity error occurred while the task was 
executing. The task was fixed in memory so that the memory could 
not be reused by another task. 


Reserved INST instruction 


Explanation: The task executed an illegal instruction, and _ no 
SST routine was specified to process the trap. 


SST abort. Bad stack 


Explanation: An SST could not be effected because the SST 
parameters could not be pushed onto the task's stack. 


Task exit with outstanding I0 
Explanation: The task exited with one or more outstanding I/0 
requests. Tasks should terminate all I/0O operations before 
exiting. The system does, however, clean up all outstanding I/0. 
T bit trap or BPT instruction 
Explanation: The task either set the T bit in the Processor 
Status Word or executed a BPT instruction, and no SST routine was 
specified to process the trap. 


Trap execution 


Explanation: The task executed a Trap instruction, and no SST 
routine was specified to process the trap. 
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Error Messages 

ABO -- Task marked for abort 
Explanation: A previous command requested that the task be 
aborted, but the abort has not yet completed. This may mean the 
task marked for abort is not currently resident in memory. 
User Action: None. 

ABO -- Task not active 


Explanation: The specified task is not currently active. 


User Action: Check command for proper task name and reenter it. 


7.4 CONTINUE 
CONTINUE resumes execution of a previously suspended task. 


Nonprivileged users can continue tasks initiated from their own 
terminals. Privileged users can continue any suspended task. 


Format 
CONTINUE[/TERMINAL:ddnn:] [taskname] 
Command Qualifier 
/ TERMINAL: ddnn: 

Parameter 


If you do not supply a parameter, the task running at your 
terminal initiated by the RUN command is continued. 


Tasks are suspended through the execution of a SPNDSS_ directive 
within the task. A RSUMS directive is another way of continuing 
a suspended task. 

taskname 
Specifies the suspended task you wish to continue. If you do not 
specify a task name, the default is a task named after the 
terminal. 

Command Qualifier 


/ TERMINAL: ddnn: 


Allows you to continue a suspended task running on some. other 
terminal. This is a privileged qualifier for RSX-11M-PLUS only. 
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Example 


“RUN YOYO 

"Messade from Yoxo: Yovo is susrended* 

SHOW TASK/ACTIVE TT10 

TT10 070530 GEN 00677100-CCG701600 FRI - 50. ODFRI ~ SO, 
STATUS: ~-CHK SFN -FMD REM MCR 
TI - TTi0: TOC - 0. EFLG 000001 00600000 FPS 170000 FC 001254 
REGS 0-46 061372 000037 000012 140311 001254 

CONTINUE 

"Message from Yoyo! Not susrended, Climbing strings" 


In this example, the user ran a task that issues a message and 
then suspends itself. Not all suspended tasks issue such 
messages, but you can identify a suspended task through SHOW 
TASKS/ACTIVE. The user issued SHOW TASKS/ACTIVE and named the 
task. Included in the listing under STATUS on the second line 
the mnemonic SPN verifies that the task was suspended. The user 
issued CONTINUE without naming the’ task. Since the task was 
initiated by RUN, CONTINUE defaulted to a task name based on the 
name of the terminal. 


Notes 
A task cannot suspend any task other than itself. 


For more information on task states, see the RSX-11M/M-PLUS 
Executive Reference Manual. 


Batch jobs may include the noninteractive form of CONTINUE as a 
no-operation command. See the RSX-11M-PLUS Batch and Queue 
Operations Manual for more information. 

Error Message 

CON -- Task not suspended 


Explanations Command attempted to continue an unsuspended task. 


User Action: None. 


7.5 CANCEL 


CANCEL eliminates entries from the clock queue. Entries are placed in 
the clock queue through the RUNS directive or from the privileged 
time-based forms of the RUN command. 


Nonprivileged users can only cancel entries from a task initiated from 
the entering terminal. Privileged users can cancel any clock queue 
entries. 


CANCEL does not affect a currently executing task, but only the 
pending entries in the clock queue. 
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Format 


CANCEL 
Task? taskname 


CANCEL taskname 
Parameter 
taskname 


Specifies the name of the installed task whose clock-queue 
entries you wish to eliminate. 


Example 


SRUN/DELAY?SM ARDVEK 

*SHOW CLOCK. QUEUE 

ARDVRK Scheduled at L7-JUL-82 10344731567 
“CANCEL ARDIVERK 

“SHOW CLOCK QUEUE 


In this example, the user issued a command to run the _ installed 
task ARDVRK at exactly five minutes from when the command was 
entered. The user verified that ARDVRK was in the clock queue 
(as the only entry). Then the user issued the CANCEL command to 
eliminate the scheduled run of ARDVRK. The user issued a _ second 
SHOW CLOCK QUEUE to verify that the scheduled entry was cleared. 
If ARDVRK had been running at the time, the CANCEL would have had 
no effect. 


Notes 


See Section 7.12.9 for information on SHOW CLOCK QUEUE. 


7.6 STOP/BLOCK 
STOP/BLOCK blocks an installed running task. The task no longer 
executeS or competes for memory. Nonprivileged users can block tasks 
running from their own terminals. Privileged users can block any 
task. 
Format 

STOP/BLOCK[/qualifier] [taskname] 

Command Qualifier 

/ TERMINAL: ttnn: 
Parameter 
taskname 

Names the task to be blocked. If you do not name a task, the 


task initiated with the RUN command and named after the terminal 
is blocked. 
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Command Qualifier 
/7TERMINAL:ttnn: 


This is a privileged qualifier for RSX-11M-PLUS only. Specifies 
that a task running from the named terminal is to be blocked. 


Example 


RUN ADVENT 

“SHO TASK/ACTIVE 

MCRa es 

SHOTS 

TTS 

*STOP/BLOCK 

>SHOW TASKS TTS/FULL 

TTS 190604 GEN 073464 00541000-005436 FRI - SO. DFRI - 
50. 

STATUS: BLK -CHK WFR -FMD REM MCR 

TI - TTS: IOC - O- BRIO - 0. EFLG - 000001 006000 FS - 170000 
FC - 002206 REGS 0-6 0014637 040066 040060 1402311 163500 000000 001252 


SSTART/UNBLOCK 

>SHOW TASKITTS/FULL 

TTS 100604 GEN 073464 00541000-005436 PRI ~ 50. DFRI - 50, 
STATUS: -CHK WFR -FMDI REM MCR 

TI - TTS: «OC - 146 BIO - Ge EFLG - 000001 0600000 FS - 170000 

FC - 002206 REGS 0-6 006173 042066 040060 140311 143500 000000 001240 


In this example, the user on terminal TT5: ran a task with the 
RUN command, giving the task the name TTS by default. The user 
then issued the STOP/BLOCK command, without naming the task. The 
/FULL display from SHOW TASKS shows task TT5's status as blocked 
(BLK flag). Then the user issued the START/UNBLOCK command and 
checked the status 9 again. This time, the BLK flag is not 
present. 


Notes 


The START/UNBLOCK and ABORT commands are the only means of 
canceling the STOP/BLOCK command. 


A blocked task has an effective priority of 0. If it is 
checkpointable, any task can checkpoint it. Once checkpointed, 
the blocked task stays checkpointed because it is ineligible to 
compete for memory. A blocked, checkpointed task is unblocked 
when it is aborted. 


A task can also be blocked by the system while waiting for some 
needed resource or for synchronization purposes. 


There are no prompts from this command. 
See Section 7.12.3 for an explanation of the task status flags. 


There are several STOP/function commands associated with the 
Queue Manager. See the RSX-11M/M-PLUS System Management Guide. 
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7.7 START 

The START command resumes execution of a task that was stopped by the 

STOPSS directive. Note that starting a stopped task is different from 

continuing a suspended one. 

Format 
START[/TERMINAL:ddnn:] [taskname] 

Parameter 

taskname 
Specifies the name of the task you wish to start. If you do not 
specify a taskname, the task running at your terminal that was 
initiated by the RUN command is started, that is, a task named 
after your terminal. 

Command Qualifier 


/TERMINAL:ttnn: 


The /TERMINAL qualifier allows a privileged user to Start a 
stopped task that is running on some other terminal. 


Notes 
Several other forms of the start command are used to control the 
Queue Manager. See the RSX-11M/M-PLUS Batch and Queue Operations 


Manual and the RSX-11M/MPLUS System Management Guide for more 
information. 


7.7.1 START/UNBLOCK 
START/UNBLOCK continues the execution of a task blocked by the 
STOP/BLOCK command. Nonprivileged users can unblock any task running 
from their own terminal. Privileged users can unblock any task. 
Format 

START/UNBLOCK[/qualifier] [{taskname] 

Command Qualifier 

/ TERMINAL: ttnn: 
Parameter 
taskname 

Names the task to be unblocked. If you do not name a task, the 


task initiated with the RUN command and named after the terminal 
is unblocked, if blocked. 
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Command Qualifier 
/TERMINAL:ttnn: 


This is a privileged qualifier for RSX-11M-PLUS only. Specifies 
that a task running from the named terminal is to be unblocked. 


Notes 
See the description of STOP/BLOCK for an example. 


START/UNBLOCK does not unblock tasks blocked by the Executive 
while waiting for system resources or for synchronization. You 
can only unblock tasks blocked with the STOP/BLOCK command. 


The START/UNBLOCK and ABORT commands are the only means of 
canceling the STOP/BLOCK command. 


The system automatically unblocks a blocked task when the blocked 
task is aborted. 


7.8 INSTALL 


INSTALL includes a specific task in the System Task Directory, thus 
making it known to the system. 


An installed task is dormant until it is requested to run by the 
Executive. You can request an installed task to run through the RUN 
command or through a variety of Executive directives, including RQSTS 
(Request), RUNS (Run), and SPWNS (Spawn). 


This is a privileged command. Nonprivileged users install tasks 
temporarily through RUN, which includes most of the same qualifiers as 
INSTALL. See Section 7.2. 


Format 


INSTALL[/quaiifier[s] ] 
File(s)? [$]filespec 


INSTALL[/qualifier[s]] [$]filespec 
Command Qualifiers 


/(NO] CHECKPOINT 
/COMMAND:"taskcommand" 
/(NO] POSTMORTEM 
/EXTENSION:n 
/MULTIUSER PARTITION: parname 
/PARITITION:parname 
/PRIORITY:n 

/READONLY_ COMMON 
/(NO]SLAVE 

/TASK NAME: taskname 
/UIC: {g 7m] 
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Parameter 
{$] filespec 


Specifies the name of the task image file containing the task you 
wish to install. .TSK is the default file type. The dollar sign 
($), if present, directs the system to search for the file in the 
system UFD ‘anid; ‘on RSX=11M systems, in the library UFD. If 
you do not include the /TASK_ NAME qualifier, the task will be 
installed under a name based on the first six characters of the 
file name unless another name was assigned through the TASK= 
option of the Task Builder. See examples. 


Command Qualifiers 

/ [NO] CHECKPOINT 
Specifies whether or not the task is to be checkpointable. The 
default is set at link time, This qualifier overrides the 
link-time checkpointability specification. 

/COMMAND :"taskcommand" 
Use the /COMMAND qualifier to pass a command to the task you are 


installing. The command must be inside the "quotes" and not more 
than 40 characters long. For example, the command 


>INSTALL/COMMAND:" /LI" $PIP 


installs PIP and then passes the /LI switch to it. This results 
in a directory listing. 


/ (NO] POSTMORTEM 


Specifies whether or not a Postmortem Dump (PMD) is to be 
generated if the task aborts because of an SST error condition. 
The default is set at link time. This qualifier overrides’ the 
link-time specification. See the RSX-11M/M-PLUS Task Builder 
Manual for further information, 


/EXTENSION:n 


Specifies that n (octal) additional words of address space are to 
be allocated to a task. 


/MULTIUSER_ PARTITION: parname 


Specifies the partition into which the read-only portion of a 
multiuser task is to be installed. 


/PARTITION: parname 


Specifies the partition into which the task is to be installed. 
The default is set at link time. This qualifier overrides the 
link-time specification. 


If you name a partition that does not exist, you receive a 
warning message and the system attempts to install the task in 
the default partition GEN. 
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/PRIORITY:n 


Specifies the priority at which the task is to run. The default 
is set at link time. This qualifier overrides the default set at 
link-time. n can be from 0 through 250. 


/READONLY_ COMMON 


Specifies that a common region is to be installed as a_ read-only 
common. 


/{(NO]SLAVE 
Specifies whether or not the task is to be slaved. 


Data sent to a slaved task is marked with the TI: of the sending 
task. When the installed task receives the data, the system sets 
the task's TI: to that associated with the data. The default is 
set at link time. This qualifier overrides the link-time 
specification. 


Note that data may not be sent to a slaved task running on a 
virtual terminal. 


/ TASK NAME: taskname 
Specifies the name by which the task is to be referenced. The 


default is set at link time. This qualifier overrides the 
link-time specification. See examples, 


/UIC: [g,m] 
Specifies the default UIC for the task. This task UIC determines 
in what protection class the task belongs and thus directly 


influences file access. 


The brackets are required syntax. 


SINSTALL FATE 


This example looks for a task image file named FATE.TSK on _ the 
default device and in the default UFD and installs it as FATE in 
the STD, assuming no other name was specified at link time. 


VINSTALL $LATE 


This example looks in the system UFD (by convention, [1,54]) and, 
on RSX-11M-PLUS systems, the library UFD (by convention, [3,54]) 
for a task image file named LATE.TSK and installs it as LATE in 
the STD, assuming no other name was specified at link time. 


PINSTALL BUCKING 


This example looks for a task image file named BUCKING.TSK on the 
default device and in the default UFD. and installs it as BUCKIN 
in the STD, assuming no other name was specified at link time. 
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This example looks on the default device in the default UFD for a 
task image file named GATE.TSK and installs it as DOOR in the 
STD, overriding any task name specified at link time. 


SINSTALL/PARTITIONJLERQY KILROY 


This example installs the task image file named KILROY.TSK in a 
partition named LEROY. 


~INSTALL/CHECKPOINT/POSTMORTEM/PRIORITY: 75/TASKI LARGO KEY 


This example looks for a task image file named KEY.TSK in the 
default location and installs it in the STD under the name LARGO. 


The task is installed as checkpointable and at a priority of 75 


(decimal). If the task should exit unexpectedly, a Postmortem 
Dump is generated. 


Notes 
REMOVE counteracts INSTALL. See Section 7.9. 


Tasks can also be installed through the install-run-remove form 
of the RUN command. Such tasks remain installed only while they 
are executing. 


While such tasks are installed, they ar Similar to other 
installed tasks. You cannot, however, count on the presence of a 
task installed through install-run-remove. 


Several situations require tasks to be explicitly installed 
through INSTALL. If you wish for other tasks to be able to 
communicate with the task while it is not active, it must be 
installed. If you wish to run the task on a schedule, it must be 
installed and then scheduled using the RUN command. If a task is 
commonly used, you may wish to sacrifice pool space to improve 
system performance by installing the task. 


You can display the attributes of installed tasks with SHOW 
TASKS/INSTALLED. See Section 7.12.5. 


Error Messages 
INS -- Access to common block denied 


Explanation: Command attempted to access a common that was 
installed specifying a protection status that excludes you. 


User Action: Find out why protection was established in that 
fashion and proceed accordingly. 


INS -- Addressing extensions not supported 


Explanation: Command tried to install a task with a VSECT 
(virtual section) in a system that does not support this feature. 


User Action: None. 
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INS -- Base address must be on 4K boundary 


Explanation: The base virtual address of the task was not on a 
4K boundary. 


User Action: Relink the task. 
INS -- Can't install privileged task from non-privileged terminal 


Explanation: A nonprivileged user attempted _ to install a 
privileged task through the install-run-remove form of RUN. 


User Action: None. 
INS -~ Checkpoint area too small 


Explanation: The area allocated for checkpointing the task was 
smaller than the partition into which the task was being 
installed. 


User Action: Allocate more checkpoint space using SET 
DEVICE/CHECKPOINT and reenter the command. 


INS -- Checkpoint space too small, using checkpoint file 


Explanation: Warning message. The checkpoint space allocated in 
the task image file is too small for the size of the task 
(probably because of the /EXTENSION qualifier). The system 
supperts dynamic allocation of checkpoint space and will 
therefore use a checkpoint file on the volume to contain the task 
if it must be checkpointed. 


User Action: None necessary. The task can be relinked with more 
checkpoint space, or you can remove it and reinstall it with a 
different value for /EXTENSION if you wish. 


INS -- Common block not loaded common-name 
Explanation: The specified common block was linked to the task 
but had not been installed. 


User Action: Install the common block, then install the task. 
INS -- Common block parameter mismatch common-name 


Explanation: Parameters of a common block did not match those in 
the task's label block. 


User Action: Correct the mismatch. 

INS -- File not contiguous 
Explanation: Command attempted to install aé_ task from a 
noncontiguous file. Task images must be contained in contiguous 


files. 


User Action: Make sure you have specified the correct file. 
Reenter the command. 
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INS -- File not task image 
Explanation: Command attempted to install a task from a $file 
whose label block indicated it was not a task image. 
User Action: Make sure you have specified the correct file. 
Reenter the command. 

INS -- Illegal device ddnn: 
Explanation: Warning message, The device specified at 
task-build time by the ASG option is not in the system. The task 
will be installed but may not execute as you wish. 
User Action: Determine the impact of the omission and act 
accordingly. 

INS -- Illegal device/volume 
Explanation: Command specified a device that was not a valid 
task-residence device. 
User Action: Make sure you specified the proper device and 
reenter command. 

INS -- Illegal first APR 
Explanation: A privileged task, built to run using APR 4 or 5 as 
its base, was too large. Using APR 4, the task was larger than 
12K; using APR 5, the task was larger than 8K. If the Executive 
has been built to support 20K of address space, APR 5 is the only 
valid base APR for tasks mapping into the Executive. A 
privileged task that does not map into the Executive must use APR 
0 as its base. 
User Action: See the RSX-11M/M-PLUS Task Builder Manual for a 
description of the /PR keyword (/PRIVILEGED qualifier to LINK). 

INS -- Illegal priority 
Explanation: Command specified a priority value of less than 0 
or greater than 250. 
User Action: Reenter command after checking proper syntax. 

INS -- Illegal use of parname partition or region 
Explanation: Command attempted to install task into a CPU or 
secondary pool partition. 
User Action: Reenter command, specifying proper partition. 

INS -- Length mismatch common block blockname 
Explanation: The length parameter for the common block, as 
described in the label block for the task image, did not match 


the length parameter defined in the system. 
that 


data must match data for 


installed. 


system 
User Action: 


See your system manager. 


T=31 


A task's label block 
task before it can be 
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INS -- No checkpoint space, assuming not checkpointable 


Explanation: Warning message on systems that do not support 
dynamic allocation of checkpoint space. Command attempted to 
install the task as checkpointable, but the task was not built as 
checkpointable and therefore had no checkpoint space allocated. 
Since the system does not support dynamic allocation of 
checkpoint space, the system considers the task to be not 
checkpointable. 


User Action: If you wish, you can_ relink the task as 
checkpointable. 


INS -- No pool space 


Explanation: No dynamic memory (DSR) was available for _ the 
Common Block Directory (CBD) or Partition Control Block (PCB). 


User Action: Wait. Pool space may free up soon. If it does 
not, see your system manager. 


INS -- No room available in STD for new task 


Explanation: No dynamic memory (DSR) was available for Task 
Control Block (TCB) in the System Task Directory (STD). Task 
cannot be installed. 


User Action: Wait. Pool space may free up_ soon. If it does 
not, see your system manager. 


INS -- Not enough APRs for task image 


Explanation: The Task Builder allows you to specify the virtual 
base address of a task image as a multiple of 4K. Privileged 
tasks start at virtual 100000 (octal) to map the 16K Executive or 
virtual 120000 (octal) to map the 20K Executive. If the virtual 
base address is set too high, the task image may not be able to 
be mapped with the remaining mapping registers. 


User Actions See the RSX-11M/M-PLUS Task Builder Manual for more 
information on the /PR keyword (/PRIVILEGED qualifier to LINK). 


INS -- R/O partition parname not in system defaulting to task's 
partition 


Explanation: Warning message. Command attempted to install a 
read-only common in a nonexistent partition. Common was 
installed in task's partition. 

User Action: If you wish, you can create the missing partition. 


INS -- Specified partition too small 


Explanation: Command attempted to install task in a partition 
that was smaller than the task. 


User Action: Increase the size of the partition and reenter 
command. 


INS 


INS 


INS 


INS 


INS 


INS 
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-- Task image already installed 


Explanation: The requested task image, which was checkpointable, 
had already been installed. On systems that do not support the 
dynamic allocation of checkpoint space, checkpointable tasks that 
have checkpoint space allocated can be installed only once. 
Other tasks can be installed more than once (under different 
names). 


User Action: If the system has dynamic allocation of checkpoint 
spaces rebuild the task without task checkpoint space. 
Otherwise, make the task noncheckpointable. 

-- Task image I/O error 
Explanation: INSTALL either could not read the task image file, 
or could not rewrite the task image header because the device was 
write-locked. 


User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your system manager. 


-- Task image virtual address overlaps common block blockname 
Explanation: The virtual addresses reserved for the task image 
overlap those reserved for the common block named in the message. 


A corrupt task image file probably caused the overlap. 


User Action: Determine the state of the task image file and 
correct the error if you can. You may have to rebuild the task. 


-- Task name already in use 


Explanation: Command attempted to install a task with the same 
name as one already in the system. 


User Action: Determine if the two tasks are the same. If not, 
install your task using the /TASK NAME qualifier to change the 
name. 
-- Too many common block requests 
Explanation: Task made too many common-block requests. 
User Action: Tasks are limited to seven common-block references. 
This error can result from an improper task build or coding 
errors. Find the cause of the error and correct it. 
-- Too many LUNS 


Explanation: Task requested more than 250 LUNs to be assigned. 


User Action: Recheck task build and code for source of the error 
and correct it. 
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INS -- WARNING -- Privileged task overmaps the I/O page 
Explanation: A privileged task that is mapped into the Executive 
is usually also mapped into the I/O page in order to access the 
KT11 registers and other devices. Many tasks do not require this 
access and can uSe_ the additional 4K words of virtual address 
space for the task image. The message warns that a task that may 
require access to the I/O page might have grown too large. 


User Action: Determine the cause of the error and correct it if 
necessary. 


7.9 REMOVE 


REMOVE takes a task name out of the System Task Directory. The task 
is no longer installed. 


REMOVE/REGION takes the name of a region out of the Common. Block 
Directory and the partition list. 


This is a privileged command. 
Format 


REMOVE [/qualifier] 
Task? taskname 


REMOVE [/qualifier] taskname 
Command Qualifier 
/REGION 
Parameter 
taskname 
Specifies the name of the task you wish to remove. 


If you wish to remove a region, specify the /REGION qualifier and 
the name of the region. 


Command Qualifier 
/REGION: 20 os 


_. Specifies that you wish to remove a region from the Common Block 
._. Directory. This qualifier is for RSX-11M-PLUS systems only. i 


Examples 
“REMOVE WONTON 


This example removes the task named WONTON from the System Task 
Directory. It is no longer installed. 
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To remove an active task, you must first abort it. 

If a task is fixed, REMOVE first unfixes it and then removes it. 
REMOVE cancels all time-based requests for the task to run. 
REMOVE deallocates all receive-by-reference and receive-data 


packets for the task and detaches all attached regions. See the 
RSX-11M/M-PLUS Executive Reference Manual for more information. 


7.10 FIX 

FIX causes an installed task or region to be loaded and locked into 
memory. Subsequent requests for the task or region may be serviced 
more quickly because it is memory-resident and dees not have to be 
loaded from the disk. 

This is a privileged command. 

Format 


FIX[/qualifier] 
Task? taskname 


FIX[/qualifier] taskname 


Command Qualifiers 


‘7 READONLY: SEGMEN 


Parameter 
taskname 
Specifies the installed task or region you wish to fix in memory. 


Command Quast erere 


- qualifiers | are £¢ 
not specify a quali tie 


"/READONLY_ SEGMENT 


ison Greats task Sarees = 


xd lows: you to eh in memory the “read-only segment of a “multiuser” 
| _ bask. = aes ba rare ab eas Aas 
/REGION 


“Allows you to fix in 
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Example 

FIX ACNT 

SHOW TASK/INGSTALLED/EULL ACNT 

ACNT 061724 GEN 109670 62264100-92342000 FRI - 50. DPRI - 50. 
STATUS!  -EXE -~-CHK -PMD FRY FXII 
TI - NONE I0C - 0 EFLG - 600000 000000 

= UNFIX ACNT 

»SHO TAS INS FU ACNT 

ACNT 061724 GEN 035370 0047000-00554700 FRI - 50, UPRI - 50, 


STATUS 3 “EXE -CHK -FAD FRY 
TI - NONE ToC - 0. EFLG - 069000 600000 


In this example, the user fixed in memory the installed task 
ACNT. The task's status, as displayed, includes the mnemonic FXD 
under STATUS and also gives the task's location in the partition 
GEN. 


Notes 
UNFIX and REMOVE counteract FIX. 


After a task is fixed, it need not be loaded into memory because 
it is already memory-resident. Requests to run the task can be 


ca | A ick] 
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Fixed tasks remain memory-resident even after they exit or abort. 
Fixing a checkpointable task makes it noncheckpointable. 


Active tasks cannot be fixed. However, a task must be installed 
before it can be fixed. 


The system can fix a task in memory only when the partition in 
which it is to be fixed becomes availabie. 


Not all tasks will run properly when fixed. Certain tasks may 
require data areas to contain certain values when loaded in from 
the disk. The first time the task is run, these data areas may 
be modified and the task may run unpredictably thereafter. Tasks 
that initialize their data areas, and therefore do not have this 
problem, are called serially re-entrant. 


Overlaid tasks may be fixed and, if their root segments are 
serially re-entrant, will run correctly. However, since their 
overlaid segments must still be read in from disk (unless’ the 
task was built using memory-resident overlays), not much is 
gained by fixing them. 

Error Messages 

FIX -- Partition busy 


Explanation: The partition in which the task was to be fixed is 
occupied, so the task cannot be fixed. 


User Action: Wait or install the task in another partition. 
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FIX -- Task already fixed 
Explanation: The specified task is already fixed. 
User Action: None. 

FIX -- Task being fixed 


Explanation: The specified task is in the process of being 
fixed. 


User Action: None. 


7.11 UNFIX 

UNFIX frees a fixed task or region from memory. The effect is to 
allow tasks that have been waiting for space in the partition in which 
the fixed task resides to compete for that space. 

This is a privileged command. 


Format 


UNFIX[{/qualifier] 
Task? taskname 


UNFIX[{/qualifier] taskname 


Command Qualifiers 


Y/REGLON 2 SS 
‘/READONLY | SEGMENT 


Parameter 
taskname 
Specifies the name of the task you wish to unfix. 


If you wish to unfix a region, specify the name of the region for 
this parameter. 


Command Qualifiers 


These mueee are for. -RSX-11M=PLUS - ‘Systems PRS See 


“/RESTON 


Specifies that you wish to. vunfix: a common = “region opather” than: a 
task, Seat eg ae a a Re eS 


‘iain aaa’ 


Specifies that you wish to. “unfix the read-only segment ‘of a 


multiuser task. 


Example 


See example in Section 7.10. 
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Notes 


A fixed task remains fixed after it exits or aborts. Therefore, 
it must be explicitly unfixed or removed. 


Error Message 
UNF -- Task not fixed 


Explanation: Command attempted to unfix a task that was not 
fixed. 


User Action: None. 


7.12 SET AND SHOW 


All users can display information about partitions, active and 
installed tasks, the clock queue, and logical-unit-number assignments. 


Privileged users can establish and eliminate partitions and change the 
priority of active tasks. 


7.12.1 SET PARTITION 


SET [NO]PARTITION creates or eliminates partitions in system memory. 
This is a privileged command. 


A partition is a contiguous area of memory with a name, a size, a 
fixed base address, and a type. 


RSX-11M partitions. can be of four types: system-controlled, 
task-controlled, common regions, and device commons. In addition, 
task-controlled partitions can have subpartitions. 
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Format 


SET NOPARTITION: parname 

SET PARTITION: parname/qualifier[s] 
Base? n 

Size? n 


Required Qualifiers 


/BASE:n 
/SIZE:n 


Qualifier 


/TOP:arg 
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RSX-11M Partition Types | 


/ COMMON 

/DEVICE:. 

f SYSTEM 

/ TASK 

/TOP:arg 

/{NO]SUBPARTITION: subpavaawe 


RSX- i Seat Partition fypes: 


/DEVICE 
‘/DIAGNOSTIC 


Required Argument 


parname 


Partition names are from one through six Radix-50 characters. 


Each partition (or subpartition) must have a name, 
SET NOPARTITION eliminates the named partition. 
Required Qualifiers 


/BASE:n 


Specifies the starting address of the partition. n is 


physical base address specified in 64-byte units. 


/SIZE:n 
Specifies the size of the partition. nis the size in 64-byte 
units. 
n 
The argument for the base and size of the partition can be 
entered in a number of formats. In all formats, n is a number 
that is multiplied by a factor to calculate the value to be used. 
See Table 7-1. 
Table 7-1 
Base and Size Specifications for SET PARTITION 
Calculated 
Format Value Base Range Size Range 
Octal nnnn (nnnn*100 ) 0<base<177777 0<size<2000 
Decimal nnnn,. (nnnn.*640) 0.<base<65535. O<size<1024. 
Octal K nnnk (nnn*4000) 0<base<3777K O0<size<40K 
Decimal K_ nnnk (nnn.*2048.) 0<base<2047.K 0.<size<32.K 
For system-controlled partitions, these values can range from 0 
through 1920.K, or any valid representation of these limits. The 


upper limit is the size of your system's memory. 
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Qualifier 
/TOP:arg 


The /TOP qualifier moves the top boundary of the specified system 
according to the form the argument is stated in. The argument is 
a number of 64-byte blocks, expressed in one of the _ five 
following formats: 


+n Moves the top boundary of the partition up by _ the 
specified amount, making the partition larger. 


-n Moves the top boundary of the partition down by the 
specified amount, making the partition smaller. 


n Makes the partition the specified size by moving the 
top boundary. 


{+]* Moves the top boundary of the partition up as far as 
possible. 


-* Moves the top boundary of the partition down as far as 
possible. 


Partition Types 
/SYSTEM 


Both RSX-11M and RSX-11M-PLUS have system partitions. System 
partitions are sometimes called system-controlled partitions. 
They are the most common type of partition on mapped systems. 
All systems including DCL are mapped systems. 


In system partitions, the Executive allocates available space to 
accommodate as many tasks as possible at one time. This 
allocation may involve moving resident tasks to arrange available 
space into a contiguous block large enough to contain a requested 
task. 


/DEVICE 


Both RSX-11M and RSX-11M/M-PLUS have device partitions. Device 
partitions are device commons, which are used by tasks to access 
the device registers of the I/O page. Device commons’ provide 
direct access to specialized I/O equipment, such as that used in 
industrial and laboratory settings. See the Processor Handbook 
supplied with your system for more information on the I/O page. 


SPPASK 


Only. RSX-11M systems. have... -».task-controlled partitions, 
Task-controlled. partitions’ are sometimes called user-controlled 
partitions. Task-controlled partitions are generally. used for 
real-time applications where explicit control of memory 


allocation. is. important... Task-controlled.. partitions. .are 
~cexclusively allocated. to.one task at a time unless divided. into 
-subpartitions. — : ; Bran 
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/{NO]SUBPARTITION:subparname. »~ 


Only RSX-11M. systems have. subpartitions. Task-controlled 
partitions can be divided into.as many as seven subpartitions. 
SET. PARTITION/NOSUBPARTITION eliminates. the .named. eHDPAreLESOR.. 


/COMMON 


only RSX-11M systems have. common . partitions. Common... partitions 
“are sometimes called common regions. Common partitions are used 
For. task communications. or data or code used. in» common by more 
than one. task. See the RSX-11M/M-PLUS” Task ‘Builder: Manual for 
“more information: on“ common regions. 


a 


- vase = “for | 
“specified partition: 
memory. 
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Examples 


SSET FARTITIONITOMPAR/SYSTEM 
Base? O02010 

Size? 160% 

“SHOW FARTITION?T TOME Ar 
FAR=TOMFAR? GOO2OLGI10G0757S 


This example creates a partition named TOMPAR with a base address 
of 002010 and a_ size of 1000 (octal) bytes. The partition is 
system-controlled. Since this is the default, the user need not 
have specified /SYSTEM in the command. 


The display from SHOW PARTITIONS is slightly different on RSX-11M 
systems in that the word MAIN appears where PAR appears in this 
example, 


“SET NOFARTITION 


Fartition meme? TOMPAR 
SHOW FARTITIGONS TOMPAR 
SET -~- Fartition mat in system 


This example eliminates the partition TOMPAR. 


=SET NOPARTITIONJ TSTFAR/NOSUHFARTITION 
Subrartition mame’ SHORE 


This RSX-11M example eliminates the subpartition SMOKE from the 
task-controlled partition TSTPAR. vr 


Notes 


Partitions are one of the key elements in tuning RSX-11M/M-PLUS 
systems and making the best use of available memory. 


You can specify the partition you wish your task to run in with 
the PAR option of the LINK command. You can override this 
specification with the /PARTITION qualifier to the INSTALL or RUN 
commands. 
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A system partition cannot include subpartitions specifically 
defined by the SET command. The Executive dynamically defines 
subpartitions in a system partition as needed for tasks installed 


in the partition. You should not confuse these dynamic 
partitions containing tasks with the task-controlled partitions 


On RSX-11M_ systems only, you - can define ‘subpartitions of. 
task-controlled partitions with the SET. command. = 9). 00. 


You can display the name, size, address and type of one or more 
partitions with the SHOW PARTITIONS command (Section 7.12.2). 
You can display the allocation of partitions in memory 
graphically with the SHOW MEMORY command (Section 8.1.9). 


See the RSX-11M/M-PLUS Task Builder Manual for information about 
tasks run in partitions. 


If a partition currently contains an installed task, common, or 
loaded driver, you cannot eliminate it with SET NOPARTITION. 


If, on an RSX-11M system, you eliminate -a task partition, you 
automatically eliminate any subpartitions associated with it. 


Error Messages 

SET -- Alignment error 
Explanation: Command attempted to create a partition but the 
base address or size conflicted with existing partitions or with 
the size of physical memory. 
User Action: Check command for proper values and reenter. 


SET -- Nonexistent memory 


Explanation: Command attempted to define a partition in 
nonexistent memory. 


User Action: Check command for proper values and reenter. 
SET -- Partition already exists 


Explanation: Command attempted to define a partition with a name 
already in use. 


User Action: Use another name. 
SET -- Space used 


Explanation: Command attempted to create a partition in a 
storage area already occupied. 


User Action: Check command for proper values and reenter. 
SET -- Task installed in partitions 


Explanation: Command attempted to eliminate a partition 
cantaining an installed task. 
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User Action: Determine the cause of the error and _ proceed 
accordingly. 


SET -- Too many subpartitions 


Explanation: An. RSX-11M user attempted to define more than seven 
subpartitions. in a task partition. 


User Action: None. You are limited to seven subpartitions. 
SET == Unknown main partition 


Explanation: An RSX-l1IM user attempted to create ‘subpartitions 
in’a nonexistent task partition. 


User. Action: Determine the .cause of the error and take 
appropriate action. , 


7.12.2 SHOW PARTITIONS 
SHOW PARTITIONS displays address and content information about’ the 
partitions of the system. You can display information about all 
partitions or about a single partition. 
Format 

SHOW PARTITIONS [:parname] 


Parameter 


If you do not specify a partition name, all partitions in the 
system are displayed. The format of the display is as follows: 


parname pcbaddr baseaddr parsize MAIN 


If the partition includes subpartitions, this description is 
followed by one or more lines describing the contents of the 
subpartitions. The format of these lines is as follows: 


pebaddr baseaddr parsize partype contentname 


In both of these displays, parname is the name of the partition, 
pebaddr is the address of the Partition Control Block (PCB), 
baseaddr is the starting address of the partition or 
subpartition, parsize is the size of the partition in bytes, and 
partype is one of the following: 


MAIN Main partition 

TASK Dynamic task subpartition - not /TASK 
(user-controlled) 

SUB Subpartition -— RSX-11M only 

DRIVER Device driver partition 

RO COM Read-only common partition 

RW COM Read-write common partition 

DEVICE Partition is a common mapped to the I/0 page 

SEC POOL Partition is a secondary pool 
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In addition, contentname is indicated as follows: 

{taskname] An inactive resident task 

<TASKNAME>.: <An° active task on RSX-l1IM-—PLUS 

me An active ‘task on RSX-11M 

‘(ddz) "" * “tndicates Specific device driver ‘on. RSX-l1IM-PLUS” 
Indicates specific device driver on RSX-11M 
Indicates the name of the first 
installed task that is associated with a 
an unnamed common, usually the read-only 
segment of a multiuser task 


! yyyy ! Indicates the name of the common 
parname 
Specifies the name of the spar tren about which you wish 
information | tO. _ pe pares eons Boas 


seraed a Panett tole Se 


tn this isu aye the fields | ee the: 


partition display — 


‘single 


multiple. parete ton, are. ser acnsieer “See 
examples. i 
On RSX-11M, the display is identical for system partitions. For 


task... (user-controlled a aa a any subpartitions are also 


displayed, as follows: 


MAIN=parname :baseaddr:parsize: TASK 
SUB=parname:subparname:baseaddr:parsize 


Examples 


~SHOW PARTITIONS 


SYSFAR 


DRVEAR 


LIRFAR 


SECPOL 
GEN 


O357 2G 
034330 


035610 
035324 
G35260 


035544 
033774 


354354 
35376 
1277210 
041324 
062124 


0 


O02Z01000 
00201006 


00224006 
OG224900 
00227690 


00364000 
06364900 


00427000 
00477000 
00477006 
00323000 
OO545100 


GO010000 
GO019906 


7 


O01 400006 
000624600 
00904 400 


+ 


090003000 
0090030090 


OOOSOGGS 
04701000 
00624060 
90004400 
OO0124600 


MAIN 


TASE 


Met 
DRIVER 
DRIVER 


SEC POOL 


MAIN 
RW COM 
TASK 
TASK 


(LEY) 
CHE} 


eae LORS 


iFCSFSL! 
POOL 


LPP G 


RUNNING TASKS 


SHOW TASKS 


044340 067463300 900004100 TASK < TTS 


+ 


OF 


< 


> 


This example shows the display from SHOW PARTITIONS when no 
partition is named. Information on all partitions and dynamic 
task subpartitions in the system is displayed. DRVPAR contains a 
number of device drivers, each in its own sSubpartition. Notice 
that SYSPAR's base address is 00201000 and its size is 10000 
(octal) bytes. See next example. 


>SHOW FARTITION: SYSFAR 
PAR=SYSPAR? 902010 ;00010075YS5 


This example shows the display from SHOW PARTITIONS when a 
partition is named. No information about subpartitions or about 
any tasks in the partition is displayed. Notice that SYSPAR's 
base address is given as 002010 and its size is 100 64-byte 
blocks. 


“ESHOW PARTI FIONTTSTEAR Sooo ee 
MAIN=TSTPARZOOZ4657i{ 0007007 TASK 
SUB-TSTPARTSMORKE $0036575000010 


play. .when. SHOW..PARTITIONS. names 
includes a subpartition. 


This RSX-11M example show 
a task-controlled partiti 


Notes 


SHOW PARTITIONS unadorned is the equivalent of the MCR PAR 
command. 


SHOW PARTITIONS with a partition name is the equivalent of the 
MCR SET /PAR=parname command on RSX-11M-PLUS or the MCR SET 
/MAIN=parname command on RSX-11M. 


7.12.3 SHOW TASKS 


You can display information about active and installed tasks on_ the 
system in a number of ways. Section 7.12.3.1 covers the display of 
Static information about tasks active on your terminal or elsewhere on 
the system in full or brief format. Section 7.12.3.2 explains the 
display of static information about installed tasks in full or brief 
format. Section Wel2vseseol explains the dynamic display of 
information about active tasks and Section 7.12.3.3.2 explains the 
dynamic display of the Active Task List. Section 7.12.3.4 explains 
the display of the LUNS of an installed task. 
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7.12.3.1 SHOW TASKS/ACTIVE 


SHOW TASKS/ACTIVE displays information about active tasks in brief and 
full format. 


Brief Format 
>SHOW TASKS/ACTIVE[:ttnn:][/qualifier[s] ] 
Command Qualifiers 


/ BRIEF 
/ALL 


ttnn: 
If you name a terminal in the command, the display shows in brief 
form the tasks active at that terminal. If you do not name a 
terminal, the display shows in brief form the tasks active at 
your terminal. 

Command Qualifier 

/BRIEF 
Specifies that you wish to display information about active tasks 
in the brief format. This is the default and need not be 


specified. 


On RSX-11M systems, the brief format includes task names only. 


e brief format includes task names and 
parentheses | next. to each" task” name. 


Fae ee ia ee Bea 


the “originating ator 


/ALL 
Specifies that you wish to display information about all tasks 
active on the system. The default is to show information about 
tasks active at your terminal oniy. 

Examples 


“SHOW TASKS/ACTIVE 
MCR ees piles 
SHOTS ATTS#) 


This example shows the brief display from SHOW TASK/ACTIVE. In 
this case, the tasks are MCR..., the central command dispatcher, 
and SHOT5, the SHOW task itself. 


-On RSX-11M-PLUS systems, t the. ‘terminal | from “which the | “task is: 
running. is also- ‘displayed. oS Seas ce ena 


*SHOW TASKS/ACTIVEZALL 


LIRR... €COOt)— 
RMDEMG €TTO) 
SHOH2 CHT 28). 
NETACF (C003). 
MOE, Prez 
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Full Format 


SHOW TASKS/ACTIVE/FULL [taskname] 
SHOW TASK[:taskname] /ACTIVE/FULL 


taskname 
If you include a task name, the display shows full information on 
that task. If you do not name a task, the display shows full 


information on all currently active tasks. 


Command Qualifier 


/ FULL 
Requests the full format display for the SHOW TASK/ACTIVE 
command. This format includes detailed information on the state 
of one or all tasks active on the’ system. The format of the 


display is as follows: 


taskname tcbaddr parname pcbaddr taskaddrlimits pri defpri 

STATUS: statusflags 

TI - ttnn: IOC - iocount BOC -buffiocount EFLG -eventflags PS -pswval 
PC - peval REGS 0-6 rrival r2val r3val r4val r5val r6val 


In this display: 


tcbaddr The physical address of the Task Control 
Block (TCB) 

parname The name of the task's partition 

pebaddr The physical address of the Partition 
Control Block (PCB) 

taskaddrlimits The base and top of the task's dynamic 
subpartition as physical addresses 

pri The priority at which the task is actually 
running 

defpri The default priority at which the task was 


built or installed to run. 


STATUS The task's status flags. These are 
identified in Tabie 7-2. 
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rk 
Toc 


BIO 


EFLG 
pswval 
peval 


REGS 


issued. 
real time) 


Status 
Flag 


ABO 
ACP 
AST 


BLK 
CAP 


CAL 
~CHK 
CIP 
CKD 
CKP 


CKR 
CLI 
DST 
-EXE 
FXD 
GFL 
HLD 
HLT 
MCR 
MSG 
NET 
NSD 


If the task is not in memory (OUT flag displayed, 
the PC, PSW, and other registers are not displayed. 


This display shows the state of the task at the time the 
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The initiating terminal 
The decimal I/O count for the task 


The decimal count of I/0 buffered by the 
terminal driver and Executive 


Local event flags 

The Processor Status Word 

The Program Counter 

The contents of the task's other registers. 
If the task was spawned by another task, the 


name of the parent task is also displayed. 


see Table 7-2), 


command 


You can display similar information dynamically (in 


for a single task 
explained in Section 7.12.6. 


TCB 
Flag 


T2.ABO 
T3.ACP 
T2.AST 
TS.STP 
T2.CAF 
T3.CAP 
TS.CHK 


TS.CIP - 


TS.CKD 


TS.CKP 


TS.CKR 
T3.CLI 
T2.DST 
TS.EXE 
T2.FXD 
T3.GFL 
TS.HLD 
T2.HLT 
T3.MCR 
TS.MSG 
T3.NET 
T3.NSD 


with the /DYNAMIC qualifier, as 


Table 7-2 
Task Status Flags 


Meaning 


Being aborted 

Ancillary Control Processor 

AST state 

Blocked externally by CLI command 


Dynamic checkpointing allaratian fFailnra 


~~ wa ee es oe 


Checkpoint space allocated in task image 

Not checkpointable 

Blocked for checkpoint in progress 
(RSX=11M-PLUS. only) 

Checkpointing disabled 

Checkpointed: (RSX-11M-PLUS. only). 

Checkpoint. in progress or checkpotuted 
(RSX-11M .only) 

Checkpoint request pending 

Command Line Interpreter 

ASTs disabled 

Not executing 

Fixed in memory 

Task has own group global event flags locked 

Half-loaded, awaiting pool for task header 

Being terminated 

Activated by MCR 

Aborted, waiting for TKTN message 

Network protocol level 

Cannot receive data (no send data allowed) 


(Continued on next page) 
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Table 7-2 (Cont.) 
Task Status Flags 


Status TCB 

Flag Flag Meaning 

-PMD T3.PMD Suppress PMD on SST abort 

OUT TS.OUT Out of memory 
T3.PRV Privileged 
T3.RDN T/O being run down 
T3.REM Remove on exit 
T2.REX Abort AST effected or in progress 
T3.ROV Resident overlays 
T3.RST Restricted - used by layered software 
T2.SEF Stopped for event flag 
T3.SLV Slaved 
T2.SPN Being suspended 
T2.SPN Suspended prior to AST 
T2.STP Stopped 
T2.STP Stopped prior to AST 
T3.SWS Reserved for software services 
T2.WFR In a wait-for state 
T2.WFR In a wait-for state prior to AST 


". ““0RSX-11M-PLUS-only ‘Task Status Flags’: - 


<< P4. EDD =< Tas Ss lead device. has” “been dism 
2 TA MUT sk is multiuser: task. . vs 


= PAs PRO: Task is (or should be) -a ae 
4. ae eo eee but BS oiss 


Note: These status flags are displayed by several forms of the 
SHOW TASK command. They give information on what is happening 
within the task and between the task and the system. They also 
identify certain kinds of tasks. Names prefixed by a minus (-) 
indicate the complement of the condition. Thus, -CHK means’ the 
task is noncheckpointable. You must understand how the system 
runs tasks to understand the meanings of all these flags. See 
the RSX-11M/M-PLUS Task Builder Manual, the RSX-11M/M-PLUS 
Executive Reference Manual, and the RSX-11M/M-PLUS Crash Dump 
Analyzer Reference Manual for more information. The CDA manual 
has a full explanation of the contents of the TCB. 


Examples 


=SHOW TAS/ACT/FULL TT7 

fT? 06467234 GEN 064244 016746500-02062100 FRI - 50. ODPRI - 30. 
STATUS: -CHK WFR -PMD REM NCR 
TI - 777? TOC - 1. EFLG - 000000 0400600 FS-70004 FC-072132 
REGS 0-4 04113060 051172 000000 000040 010400 051520 001472 


This example shows the display in full format for the task named 
TT7 (initiated by a RUN command from terminal TT7:). The task is 
running in the default partition GEN at a priority of 50. The 
task is not checkpointable. It is in a "wait-for" state. No PMD 
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will be generated. The task is to be removed on exit (meaning it 
was installed with the install-run-remove form of RUN), and it 
was activated by MCR. (Many tasks requested from DCL are 
actually activated by MCR.) 


=>SHO TAS/ACT/FUL 

eo +L OR 034210 LOIRPAR 033774 00364000-00367000 FRI - 248. ODOFRI ~ 248. 
STATUS: STF - PMD FRY NSD FX> 
TI - COOt I0C - 0. EFLG - 900001 000000 FS ~ 170000 PC - 120526 
REGS 0-6 0600162 024207 177777 066640 066610 066314 120250 

RMDEMO 044320 GEN 046640 01367700-01415100 PRI - 225. DRRI ~- 225, 
STATUS! -CHK WFR -FPMD FRY MCR 
TI - T7623 IOC - OO. EFLG - 000035 040000 FS - 170010 FC - 125014 
REGS 0-6 000002 131316 131436 000000 135055 000000 121240 

MCRe++ 116464 SYSFAR 0346330 002019000-00211000 FRI - 160. DPRI ~ 160. 
STATUS! STF -PMND FRY CLI NST CAL 
TI - TTO? IOC - OO, EFLG —- 000001 040000 FS ~- 170000 FC - 124412 
REGS 0-& 600000 120556 000400 120512 000100 120572 120442 

HCL... 115530 GEN 037344 00624700-00634700 FRI - 160. DFRI - 160, 
STATUS? STF -PMD PRY CLI NST CAL 
TI - TTi03 I0C - 0. EFLG - 100001 040000 FS ~ 170000 FC - 124470 
REGS 0-6 025550 025550 000000 120426 123530 000000 120342 

SHOT10 066314 GEN 066610 02221700-02261700 FRI ~ 140. DUFRI ~ 160, 
STATUS: -FMD REM PRY 
TI - TT10: IOC - 6. EFLG - 000001 046000 FS - 170017 FC - 121202 
REGS 0-6 000000 131574 050712 000000 900000 000000 6012164 

ROOFL 1175760 GEN 0346770 00537000-00624700 FRI - 149. DFRI ~- 1497, 
STATUS! STF ACF -FPMD PRY NES CAL ROV 
TI - COO: I0C - GO. EFLG - 900002 640001 FS - 170000 FC - 120546 


+ 


LFFO 061444 GEN 062504 00725200-00740000 FRI - 80, DFRI - 80, 
STATUS: STP FRY 
TI - COO: IOC - 0. EFLG - 000460 140000 FS - 170000 FC ~ 120644 


REGS 0-6 1215246 121640 000115 124676 000000 000001 120342 
FARENT TASK NAME ~ QMG... 

LPF 062024 GEN 062374 01351200-01364000 FRI ~ $0. UFRI ~- 80, 
STATUS! STF PRY 
TI - COO? IOC - 6. EFLG - 000400 040000 FS - 170000 FC - 120644 
REGS 0-6 120362 000061 0000460 140164 140440 G00000 120342 


mAMmEaier TAG AbA AE” Omir 
rFRAnorms PVN Wr Aghwee ob 4 


AT,TiO 641174 GEN 040640 020662100-02142000 FRI - 80. DFRI - 80. 
STATUS’ SEF STF WFR -PMD REM FRY MCR 
TI - TT10% I0C ~ 6. EFLG - 000000 140000 FS - 170010 FC - 141604 
REGS 0-6 123551 123416 000122 115530 000000 000000 126664 

QMG... 061340 GEN 056354 01327700-013551200 FRI - 75, UFRI ~ 75, 
STATUS! STF PRY 
TI - COO? f0C - 6. EFLG - 600000 040000 FS - 170000 FC ~- 120656 
REGS 0-6 121750 123350 122350 601006 000000 660000 120372 

EDIT10O 057420 GEN 0357340 02142000-02262100 FRI ~- 65. UFRI ~- 65, 
STATUS: WFR -FPMD REM 
TI - TT10? IOC - O. EFLG - 000002 100000 FS - 170000 FC - 006706 
REGS 0-6 000001 000000 017764 000000 103466 1015708 001700 
FARENT TASK NAME - AT,.T10 
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This example shows the display from SHOW TASKS/ACTIVE/FULL. 
Tasks are displayed in order of priority. Note the tasks 
displayed below the first break. Tasks LPPQ and LPP1 are 
line-printer processors. They are spawned by the Queue Manager. 
AT.T10 represents an indirect command file that spawns EDT by 
including an EDIT/EDT command, but the resulting task EDIT10 is 
not slaved. 


7.12.3.2 SHOW TASKS/INSTALLED 


SHOW TASKS/INSTALLED displays information about installed tasks in 
either brief or full format. 


Format 
SHOW TASKS[:taskname] /INSTALLED[/qualifier] 
Command Qualifiers 


/ BRIEF 
/FULL 


Parameter 
taskname 


Specifies the task for which you wish information displayed. - 
you do not specify a task name, information on all installe 
tasks is displayed. 


Command Qualifiers 
/ BRIEF 


Requests information on installed tasks in a brief format. This 
is the default and need not be specified. The format of the 
display is as follows: 


taskname ident parname priority size ddnn:-lbn [memstate] 


In this display, taskname is the name of the task, ident is the 
task version identification (or the version of the prototype 
task), parname is the partition in which the task is installed, 
priority is its priority, size is the size of the task in bytes, 
ddnn: is the device from which it is to be loaded, 1lbn is’ the 
logical block number of its disk address, and memstate is the 


task memory state, which can be FIXED, CHECKPOINTED, or blank. 


If the task version identification is missing (with the rest of 
the line moved left) or if it is garbage, the task was installed 


from a disk that is no longer’ present. If the task version 
number is a date, such as O7JUL, the task was compiled on that 
day. 


7-51 
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/ FULL 


Requests the full format of the SHOW TASKS/INSTALLED command. 
This format displays a detailed list of the states of one or all 
of the installed tasks in the system, depending on the _ presence 
of the taskname parameter. The format of the display is as 
follows: 


taskname tcbaddr parname pcbaddr taskaddrlimits pri defpri 
STATUS: statusflags 
TI - ddn: I0C - iocount EFLG - eventflags 


This display is in the same format as that of SHOW 
TASKS/ACTIVE/FULL. See Section 7.12.4 for a description of the 
display. 


taskname 
Specifies a task for which full information is to be displayed. 
If you do not specify a task name, information about all 
installed tasks is displayed. 


Examples 


“SHOW TASKS/INSTALLED 
LURK... 12,15 LOURPAR 248, 00002500 LEOG:-0014633160 FIXED 


TKITN 04.7 TRNFAR 248. 60010000 LkO:?-90171022 
RMDEMO Vi.G03 GEN 200, 90026700 LBO!-GO171022 
MTAACF S013 GEN 200. 060060134600 EMOL-O000C5315 
FLiiMSG VO019 GEN 200. 00025500 LEROt-00167207 
NETACF VYO2.00 GEN 200, OO0025500 DROT-006444640 
EVE... VO1.00 GEN i?9, 000123100 DRO?-906444646 CHECKFOINTED 
s++MCR 1.1 GEN 160. 006020300 LBOt-00162447 
SHOTS tae GEN 169. 00020300 LERO?-0016246? 
++ +MOU 2502 GEN 160. 00037700 LRO?-00222416 
++eDCL 00 GEN 160, 900356090 DRO? -00212612 
MCOReee 2402 SYSFAR 160. 00010000 LEO: ~-00146244% 


* 
+ 


% 


This example shows the brief format of the display from SHOW 
TASKS/INSTALLED. LDR..., the loader, is fixed in memory. The 
task EVP... is checkpointed. The final entry shown, MCR..., is 
the system command dispatcher. See next example. 


»SHOW/TASKSMCR.../INSTALLED/FULL 

MCR... 1101460 SYSPAR 11454 00202700-00212760 FRI - 160 . DFRI ~ 160 
STATUS? STP -FMI PRY MCR CLI NSE CAL 
TI - TTS: IOC - O. BIO - 0. EFLG - 900001 040000 PS - 170000 


FC ~ 122436 REGS 0-6 000000 120476 000102 120514 057020 040220 120364 


This example shows the full format of the display from SHOW 
TASKS/INSTALLED. In this case, the user named a single task. 
The default is to show the full display for all installed tasks. 
The status flags in the second line of the display are explained 
in Table 7-2. 


RUNNING TASKS 


SHOW TASKS (Cont.) 


Notes 


The brief format of SHOW TASKS/INSTALLED is the MCR TAS command. 
The full format of SHOW TASKS/INSTALLED is the MCR TAL command. 


The /DYNAMIC qualifier enables you to watch the full format 
display as it is updated. See Section 7.12.6. 


7.12.3.3 SHOW TASKS/DYNAMIC 

SHOW TASKS/DYNAMIC displays a moving picture on a video terminal of 
either a single task's activity, or of all or part of the Active Task 
List. 

The command also works on hard-copy terminals, providing a _ snapshot 
display that is different in format from the conventional SHOW TASKS 
display. 

This command is privileged if the Resource Monitoring Display (RMD) is 
not installed on the system. The command is nonprivileged if RMD is 


installed under the name ...RMD, or if your system supports) flying 
installs. See your system manager for information. 


7.12.3.3.1 SHOW TASK: taskname/DYNAMIC 
SHOW TASK:taskname/DYNAMIC displays a moving picture of the _ task's 
activity on a video terminal or a snapshot display on a hard-copy 
terminal. 
Format 
SHOW TASK: taskname/DYNAMIC[/qualifier] 
Command Qualifier 
/RATE:n 
Argument 
taskname 
Specifies the task you wish to inspect. 
Qualifiers 


/DYNAMIC 


Specifies that you wish the moving display. This function is 
performed by the RMD task. RMD has four display pages: 


e Task, which displays a task header 
e Active, which displays all or part of the Active Task List 
* Memory, which displays the contents of memory 


e Help, which provides help on RMD 
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Once you have invoked any one of these pages, through either a 
SHOW TASK/DYNAMIC command or a SHOW MEMORY command, you can move 
from one page to the other without leaving’ RMD. The first 
character of each page name is a command to RMD to go to that 
page. In addition, an ESC entered from a page permits you _ to 
enter setup commands for that page. See Section 8.1.9 for more 
information on the features of RMD. 


The setup commands for the Task page permit you to change the 
task header being displayed. The task you name remains the 
default display for the Task page. This means you can observe a 
Single task header, then jump to the Memory page or the Active 
page, and then back to the Task page and the named task will 
still be on display. 


/RATE:n 


The /RATE qualifier allows you to set the rate at which the RMD 
display screen is to be replotted on the first display. nis the 
number of seconds between replots. The default nis 1. You can 
change the rate by pressing ESC and entering a new rate. The 


rate setting returns to 1 aS soon as you change pages. If you 
wish a slower rate, you must reset the rate each time you change 
the page. 


Use this qualifier to slow down the display. 


Task headers may change more often than once per second, but once 
per second is the most rapid rate available. 


Example 
“SHOW TASK CORTS/DYNAMIC 


The screen is cleared and the following display appears: 


RSX-11M V4.1 BL33 512K 14-NOV-82 18:15:33 
Task? CORTS Partition: GEN STATUS! -CHK -FMI REM FRV CLI 

Own: TTS? I/0 = 0. DPri’ 160 Frit 160 SFrit 155 Leni 0600356000 
RO = 022120 Ri = 000764 R2 = 002230 RI = 000746 R4 = 0246246 RS = 022136 
FC = 005330 FS = 170000 SF = 022224 $DSW = 0. Eflge = 0000001 040000 
LUN File LUN File 

1. SYO% 

2- DBOIC3» 33IDEEP. DAT 

3. SYOE 

4. SYO? 

Se TIO: 

é. CLO} 

7. DRO! 


This display changes once per second and shows the task header 
for a task named CORT5S. The top line of the display identifies 
the operating system by name, version, base level and memory 
size, and also gives the date and time. The next line of the 
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display includes the task name, the partition in which the task 
is running, and the task's status flags. (See Table 7-2 for an 
explanation of the status flags.) The next line lists the task's 
owner (terminal, not UIC); the outstanding I/0 count; the 
default priority, running priority, and swapping priority; and 
the length of the task in octal bytes (top minus base). The next 
two lines display the contents of the task's general-purpose 
registers, program counter, Processor Status Word, stack pointer, 
Directive Status Word, and local event flags. The remainder of 
the display shows the logical-unit-number assignments of as many 
as 25 LUNs. (Tasks can have as many as 250 LUNS.) This task has 
conventional LUN assignments except for LUN 2, which is an open 
file. 


Notes 


You must understand how tasks run in the RSX-11M/M-PLUS 
environment to understand all the elements of this display. On 
the other hand, this display is a useful tool for understanding 
how tasks run on the system. 


Tasks built including ODT can be observed using this command, but 
if you are single-stepping through the task or otherwise using 
breakpoints, the registers displayed will be those of the ODT 
task, not those of the named task. 


This display is particularly useful for observing complex 
assemblies, as you can tell how far the assembly has gone by 
which files are open. You may also be interested in observing 
the Task Builder at work. 


7.12.3.3.2 SHOW TASKS/ACTIVE/DYNAMIC 


SHOW TASKS/ACTIVE/DYNAMIC displays a moving picture of the Active Task 
List on a video terminal or a snapshot display on a hard-copy 
terminal. 


Format 
SHOW TASKS/ACTIVE/DYNAMIC [/qualifier[s] ]} 
Command Qualifiers 
/OWNER: ddnn: 
/PRIORITY:n 
/RATE:n 


Command Qualifiers 


/OWNER:ddnn: 
ALL 


Specifies the terminal or other device from which the tasks 
displayed are being run. You can name any device, pseudo device, 
logical device name, or terminal number for this argument. The 
default argument is ALL, which displays tasks owned by all 


devices on the system. 
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You can change the owner displayed by pressing ESC and entering a 
new device name. 


Note that this qualifier differs from other “owner"™ qualifiers in 
DCL in that it names a terminal and not a UIC as the owner. 


/PRIORITY:n 


Specifies the highest priority to be displayed. The default is 
250, the highest priority on the system. 


Use this qualifier to shorten the display to within one screen's 
worth. 


You can change this value by pressing ESC and entering a new 
priority. 

/RATE:n 
The /RATE qualifier allows you to set the rate at which the RMD 
display screen is to be replotted on the first display. n is the 
number of seconds between replots. The default nis 1. You can 
change the rate once the display begins by pressing the ESC key 
and entering a new rate. The rate setting returns to 1 as_ soon 
as you change pages. If you wish a slower rate, you must reset 
the rate each time you change the page. 
Use this qualifier to slow down the display. 


The Active Task List may change more often than once per’ second, 
but once per second is the most rapid rate available. 


Example 
“SHOW TASKS/ACTIVE/DYNAMIC 


The screen is cleared and the following display appears: 


RSX-1LiM V4.1 BL33 S12K OWN=ALL 14-NOV-82 19:08:55 
Name Length TI Fri I/O Status fless 

LURK... 00002500 COO 248, Oo. -CHK FXO STF -FMD FRY NST 
RMDEMNO 00026700 TTO 225, Oo. ~CHK WFR -FMD PRY ACR 
SHOHO 00026700 HTO 225, GO. -CHK -FMI FRY MCR 

NETACF 00025500 COO 200, Oo. STF ACF -FMD FRY NSH 
EVF.4+ 00014200 C00 199, Oo. STF -FMI FRY 

QNCLTS 00035600 TTS 160, O, -CHE STF REM FRY CLI 
DROFCF 00044000 COO 149. Oo. -CHK STF ACF -PMD FRY NSO 
LF'O 00014100 COO 70. Oo. STF FRY SLY 

TTS 000024600 TTS 50, 1, -CHK WFR -FMD REM WCR 


The screen changes once per second and displays the Active Task 
List. The first line identifies the operating system, version 
number, base level, memory size, the current owner of the tasks 
being displayed, and the date and time. Since the current owner 
is ALL, the remainder of the display is the Active Task List 
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itself. The display includes the task name, its length in octal 
bytes, its running priority, outstanding I/O count, and the 
status flags for each task. (See Table 7-2 for an explanation of 
the status flags.) 


>SHOW TASKS/ZACTIVE/DYNAMIC/OWNERS TTS: 


The screen is cleared and the following display appears: 


RSX-1imM V4.1 BL33 Si2k OWN=TTS: 2I-NOV-82 L4atrSrii¢ 
Neme Length TI Fri I/O Status flags 
SHOTS 00026700 TTS 6. CHEK -FMO REM FRY HCR 


This example displays the Active Task List for a single terminal. 
The only task active at the terminal is the SHOW command itself. 


Notes 


The RMD display is in order of priority. When a new task comes 
in, all tasks below it in priority are displaced on the screen, 


See Section 8.1.9 for more information on RMD. 


7.12.3.4 SHOW TASK/LOGICAL UNITS 


SHOW TASK: taskname/LOGICAL UNITS displays the static 
logical-unit-number assignments (LUNs) for an installed task. 


Format 


SHOW TASK: taskname/LOGICAL UNITS 


Argument 
taskname 


Specifies the task for which you want LUN assignments displayed. 
This must be the name of a task installed through INSTALL, and 
not through the install-run-remove form of RUN. 


The display consists of a list of physical devices and 
corresponding static LUN assignments. The display does not show 
any dynamic LUN assignments, even when the specified task is 
running. 


Tasks installed through the install-run-remove form of RUN do not 
have any static LUN assignments. 
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Examples 


>SHOW TASK? TEWKSY/LOGICAL_UNITS 


URLs od. 
DBL: 2. 
DRLit 3. 
DRL: 4. 
TIO? 65. 
CLO} 6, 


This example shows the display. 


“SHOW TASKITT7/LOGICAL 
SHO -- Task mot in system 


This example shows the error message received when you attempt to 
show the LUNs of a task installed through the install-run-remove 
form of RUN. 

Notes 


You can display information about a terminal's logical 
assignments with SHOW ASSIGNMENTS, Section 5.10.1. 


You can display information about the LUNS of a task installed 
with the install-run-remove form of the RUN command with the SHOW 
TASKS/DYNAMIC command. See Section 7.12.6. 

SHOW TASK/LOGICAL UNITS is the equivalent of the MCR LUN command. 


For more information on logical units, see Chapter 5. See also 
the RSX-11M/M-PLUS Task Builder Manual. 


Tasks can dynamically alter their LUN assignments through’ the 
ALUNS Executive directive. 


Error Messages 


Explanation: Informational message. The task did not have any 
logical units. 


User Action: None. 
SHO -- Task not in system 


Explanation: Informational message. Command specified a _ task 
that is not in the system, or that was installed by means of the 
install-run-remove form of RUN. 


User Action: SHOW ASSIGNMENTS displays logical device 
assignments for your terminal. SHOW TASKS/DYNAMIC can display 
LUN assignments for tasks installed with the install-run-remove 
form of RUN. 
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7.12.4 SET PRIORITY 
SET PRIORITY alters the priority of an active task. 
This is a privileged command. 

Format 


SET PRIORIT 

Priority? pnum 

Task? taskname 

SET PRIORITY:n taskname 


Parameters 
pnum 


Specifies the new priority you wish to assign to the _ task. 
Priority numbers are in the range of from 1 through 250. no is 
octal or decimal. You must add a decimal point to decimal 
numbers. 


taskname 


Specifies the name of the active task whose priority you wish to 
alter. 


Example 


“SHOW TASKiTT7Z/FULL/ACTIVE 

TT7 066734 GEN 064244 01676500-02062100 FRI - 50. ODPRI - 50, 
STATUS$ -CHK WFR -PMO REM MCR 
TI ~ TT7? IOC - 1. EFLG - 000000 0400090 FS-70004 FC-072132 
REGS O-6 041130 051172 G00000 000040 619400 051520 001472 

7SET PRIORITY 

TASK? TT? 

FRIORITY? 199 

SET -- Syntax error 


-SET PRIORITY TT? 199. 

*-SHOW TAS ACT FUL TT? 

TT? 066734 GEN 0464244 01676500-02062100 FRI ~- 199, DRRI ~ 199. 
STATUS? -CHK WFR -FMI REM MCR 
TI - TT7? TOC - 1, EFLG ~ 000900 640000 FS-70004 FC-072132 
REGS 0-6 0641130 051172 000000 009040 010400 051520 001472 


“SET PRIORITY TT? 225 

“SHOW TAS ACT FULL TT? 

TT? 066734 GEN 064244 01676500-02062100 FRI - 149. DPRI - 149, 
STATUS: -CHK WFR ~-FMD REM MCR 
TI - TT? IOC - 1, EFLG - CO6000 640000 FS-70004 FC-072132 
REGS 0-6 041130 051172 000000 600040 016400 O51520 001472 


This example shows the effects of SET PRIORITY. The user first 
displayed the priority of task TT7 with SHOW TASKS/FULL/ACTIVE. 
The user then issued SET PRIORITY to change the task's' priority 
to 199 but did not terminate the priority number with a decimal 
point. The system rejected the command because it recognized 
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that a number containing a 9 was not an octal number. The user 
then issued the command with the decimal point and it was 
processed. The user then attempted to change the task's priority 
to 255, again omitting the decimal point. This time the command 
was processed without an error message, but the priority was 
changed to 255 octal, which is 149 decimal. 


Notes 


Notice that SET PRIORITY changes both the running and default 
priority of a task. A task can change its own priority through 
the ALTP$ Executive directive. With this directive, only the 
running priority is changed. 

SET PRIORITY is the equivalent of the MCR ALT command. 


There is no SHOW PRIORITY command. You must use SHOW TASKS 
instead. 


7.12.5 SHOW /CLOCK QUEUE 
SHOW /CLOCK QUEUE displays information about tasks currently in _ the 
clock queue. The information consists of the task names, the next 
time each task is to be run, and each task's reschedule interval, if 
one was specified. 
Format 
SHOW /CLOCK QUEUE 

Example 

“SHOW /CLOCKU QUEUE 

LIONEL SCHEDULED AT 29-OCT-82 17241:331:!51 RESCHEDULE INTERVAL O5 SECS 

ONEUPF SCHEDULED AT 29-OCT-82 17148%44{05 


CALDOR SCHEDULED AT 29-GCT-82 1820019000 RESCHEDULE INTERVAL O2 HOURS 
TEWKSY SCHEDULED AT 30-OCT-82 10700!f00700 


This example shows the display from SHOW /CLOCK QUEUE. Installed 
tasks are placed in the clock queue through the scheduling 
options of the RUN command. See Section 7.2.2. 


The task LIONEL is scheduled to run at 17:41:31:51 #£=(hours, 
minutes, seconds, ticks) and every 5 seconds thereafter. 


The task ONEUP is scheduled to run at 17:48:44:05. 


The task CALDOR is scheduled to run at 18:00:00:00 and every two 
hours thereafter. 


The task TEWKSY is scheduled to run at 10:00:00:00 on the next 
day. 


Notes 
SHOW /CLOCK QUEUE is the equivalent of the MCR CLQ command. 
Installed tasks are placed in the clock queue through the 


privileged form of the RUN command. See Section 7.2.2. 
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est 


This command has nothing to do with queues under the control of 
the Queue Manager. Entries in Queue Manager queues are displayed 
through SHOW QUEUE. See the RSX-1l1M-PLUS Batch and Queue 


Operations Manual. 


“Not. ‘checkpoi 
“Checkpoint in_ progress. 
Checkpoint requested - 
Library. or common ert 
- Marked- for: delete on last 
Driver common 

“Fixed in: memory 
“bong T/O" e> 

Last load failed 
“Not shuffle, bl 


a sta the common. region. is 
‘elther fixed in mer : 
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-commonname 


“Specifies a common name ‘about | which. information is “eo bes: 
displayed. P ae a bore: 


Command Qualifier 


Specifies that you wish a list of tasks attached to a particu 
common region. showing the number of times each task is Mapped: s 
the common. (mapping count). 


Examples 


“SHOW COMMON 
ASICS 050644 
DEPRES ° 056346 
QISMBUF 0536390 STATUS COs, 
DSMSUP 064164 arien comet 
FCSFSL 417210 17 STATUS? COM” no ee 
TTCOM OFAKTO 1 STATUS BP XD COM 


“STATUS! COM 
“STATUS? | COn 


oe 


‘This example shows the: display from “the -unadorned®: SHOW COMMON 
command. Currently, six commons are installed in the system, 


SHO COMM? ISMBUF — | re 
NSMBUF OS53430 8 STATUS! COM Pre. 


This example shows tne dic play wien @ singis common is named. 


SHO COM! DSMBUF TASK 
NSMEUF 053630 STATUS: COM FIL 
DSMIG  3> 7 
ISMGAR 1 
USMT61 2 


This example shows the ‘display when ga tee of tasks is requested - 
for a single common. a ig 


Notes 


SHOW. COMMON is the equivalent of the MCR CBD command. 
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SYSTEM CONTROL 


The commands in this chapter are used to control and display certain 
system level functions. The SHOW commands in this chapter are 
nonprivileged, but all other commands in the chapter are privileged. 
Other commands needed for system control may be found in other 
chapters of this manual, in the RSX-11M/M-~PLUS MCR Operations Manual, 
and in the RSX-11M/M-PLUS System Management Guide. 


8.1 SET AND SHOW 
You can set and display the time and date, the system and library 
UFDs, and the size of the dynamic storage region (pool). You can 


display the logged-in users and the current use of memory on the 
system, and you can enable and disable logins to the system. 


8.1.1 SET DAYTIME 

SET [DAY]TIME sets the current date and time. 

Format 
SET [DAY] TIME [date] [time] 

Parameters 
Either the time or the date, or both, can be specified in the 
command. They can be specified in either order. If you do not 


specify a time or a date, you will be prompted. 


The date field and the time field must be separated by a space. 


date 
Specifies the date. You can enter the date in either of two 
formats: 
dd-mmm-yy Where dd is the number of the day, mmm is’ the 
first three characters of the name of the 
month, and yy is the number of the year 
(relative to 1900). 
mn/dd/yy Where mn is the number of the month, dd is’ the 


number of the day, and yy is the number of the 
year (relative to 1900). 


Regardless of the format you choose, the date is displayed in the 
first format. 
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time 
Specifies the time. Time is entered in the following format: 
hh:mm[:ss] Where hh is the number of the hour in the 
24-hour format and mm is the number of the 
minute. ss defaults to 00. 
Examples 


=SET TIME 
gt 


Time? 05 


This example sets the time at 8:05 on the current day. 


“SET DAY 
Late? 16-JAN-66 


This example sets the date at January 16, 1966. The time setting 


is unchanged. 


SET DAY 
Tate?’ G1/14/463 17314 


This example sets the date at January 14, 1963, and the time at 
17:14:00. The date will not be displayed in the format entered 


but as 14-JAN-63. 


“SET DAYTIME G46-JUN-44 0412001006 


“SET TIME 0470073060 O46-JUN-44 


The examples are equivalent. Both set the date at June 6, 1944, 


and the time at 04:00 hours. 


Regardless of the prompt, you can enter the date 
either order. 


8.1.2 SHOW [DAY] TIME 


SHOW [DAY]TIME displays the current time and date. The 
24-hour format and the date is formatted as dd-mmm-yy. 


Format 
SHOW [DAY] TIME 
SHOW TIME 
SHOW DAY 


Example 


>SHOW TIME 
04:00%22 06-JUN-44 


or time in 
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8.1.3 SET SYSTEM 


SET SYSTEM establishes certain characteristics of the system. It is a 
privileged command. 


Format 
SET SYSTEM[/qualifier] 
Command Qualifiers 


/EXTENSION LIMIT:n 
/ [NO] LOGINS 
/PACKETS:n 
/POOL:top:max:total 
/DIRECTORY: [g,m] 


Command Qualifiers 
/EXTENSION LIMIT:n 


The /EXTENSION LIMIT qualifier establishes the maximum size _ to 
which a task can extend itself by means of the EXTEND TASK 
directive. n can be entered in all the formats used in the SET 
PARTITION command. See Section 7.12.1. 


See the RSX-11M/M-PLUS Task Builder Manual and the RSX-11M/M-PLUS 
Executive Reference Manual for more information on the Extend 
Task directive. 


/ [NO] LOGINS 
/{NOJLOGINS enables or disables logins. 


If you issue SET SYSTEM/NOLOGINS and then log out, you will have 
to reboot the system to log in again unless there is another 
privileged user logged in. 


/PACKETS:n 


The /PACKETS qualifier specifies the maximum number of I/0 
packets to be retained ina separate queue for use by the QIO 
directive. Changing the number of retained packets helps 
optimize the servicing of QIO requests. n can be from 0 through 
15. The default is 5. 


This value is.a -system-generation option on RSX-11M systems. 


On RSX-lLIM-PLUS systems, the value is usually set as apart .of 
the startup procedure. 


This command is equivalent to the SET /MAXPKT command in MCR and 
VMR. 


SHOW SYSTEM/PACKETS displays this limit and also the number of 
packets currently available. See Section 8.1.4. 
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/POOL:top 


The /POOL qualifier increases the size of the system pool (the 
dynamic storage region). The top argument is the number of 
32-word blocks (decimal). The max argument is the maximum size 
in decimal words. The total argument is the total size in 
decimal words. 


/DIRECTORY: [g,m] 
/DIRECTORY establishes the identity of the system directory. The 
UFD you name must already exist. This command does not create a 
UFD. 
/DIRECTORY is the default qualifier for SET SYSTEM. 


See the discussion in Section 8.1.5 for information on the use of 
this command on RSX-11M and RSX-11M-PLUS systems. 


Examples 


~SET SYSTEM 
System UFDF C4954] 


SSE? SYSTEM. L3rnad 


These commands are equivalent. They establish the system 


directory as UFD [3,54] on nsenda device LR:. 


S>SET SYSTEM/EXTENSION_LIMET E1200 


This command sets the maximum size to which a task can extend 
itself through the Extend Task directive to 1200 (octal} 32-word 
blocks (decimal) or 30K words. 


VIBRARY/DIRECTORY 


the SET - LIBRARY/DIRECTORY command establishes “the library UFD~ on 
RSX- -LIM-PLUS Sys roms Sin Kain. sgn gt on ee 


See the discussion in Seok vane “8. ie ited for “the relation between SET 
CUPRART/(GIRPEORE and- PEt, | SYSTEM/DI ECTORY. Seema NE fe a BS Begs es 


Foren 
“SET " LEBRARY/DTRECTO 


SS GRE command: establishes t 
- onan RSX-1L1M-PLUS syste 
- directory. — The. directory 

command. °° ieee 


ni “not. “create. ae 
“exist “before. you. issue. ‘the 
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8.1.5 SYSTEM AND LIBRARY UFDs 


On RSX-1IM systems, the system image file and all system tasks and 
utilities. are kept..in the system directory on. pseudo: device LB. . Zou 

display the current setting for this. directory ‘with ‘the > SE 
‘EM/DIRECTORY. command... Beivileged:: users: can change the direct 
th the SET SYS TEMDIREC RORY command . 


where “you issue. a RUN. Or INSTALL celand: and. precede the. filespec (that 
is; the” task image file: name) with a dollar sign (sy; you are 
instructing. the. Ryan. etatad the. task Boas wehge ee ‘run. or install. WLS yan 
this directory. — oe Gr an sn sb Pe ie a 


. 


‘system tas S~ 
wee 


“command. 
‘SET: 


cede the: filespec’ “the. 
zou: are’. instructing the’ 
is -cin@cone-of “these: 
chea ‘first: ms and ‘then the. 


8.1.6 SHOW SYSTEM 


SHOW SYSTEM displays information about the current system. 
Format 

SHOW SYSTEM[/qualifier] 

Command Qualifiers 


/CLI 

/DIRECTORY 
/EXTENSION LIMIT 
/PACKETS — 
/POOL 

/SECONDARY POOL 


Command Qualifiers 
/CLI 


SHOW SYSTEM/CLI displays information about each command line 
interpreter (CLI) on the system. The information includes the 
name of the CLI, the name of the task that implements the CLI, 
the number of terminals set to the CLI, and several status flags 
for the CLI. 


SYSTEM CONTROL 
SHOW SYSTEM (Cont.) 


Here are the status flags: 


ACT CLI is active. 

DSB CLI is disabled. 

PRV CLI is available to privileged users only. 
RST CLI is restricted. 


For more information about adding CLIs to the system, see the 
RSX-11M/M-PLUS MCR Operations Manual and the RSX-11M/M-PLUS 
System Management Guide. 


There is no SET SYSTEM/CLI command in DCL. 
/DIRECTORY 


SHOW SYSTEM/DIRECTORY displays the current system directory. The 
display specifies SYSUIC, but the system directory rarely has a 
UIC associated with it; it is a UFD. SHOW. LIBRARY /DIRECTORY 
displays the current. library directory. See Section 8.1.5 for 
more information. 


/EXTENSION LIMIT 


The SHOW SYSTEM/EXTENSION LIMIT command displays the maximum size 
to which a task can extend itself by means of the Extend Task 
system directive. The size is displayed as an octal number of 
32-word blocks (decimal). 


/ PACKETS 


Normally, some number of 18-word I/O packets are set aside in 
pool and retained in a separate queue for use by the QIO 
directive. This number of packets (referred to as MAXPKT) is 
used to optimize the servicing of QIO requests. 


The SHOW SYSTEM/PACKETS command displays the maximum number = and 
the current number of available I/O packets in the format: 


MAXPKT=m.:c. 


where m is the maximum number of and c is the current number of 
available I/0 packets. 


/POOL 


The SHOW SYSTEM/POOL command displays the current status of the 
system dynamic pool as three numbers, flor: lfb: tps, where 
flor is the first location available for user partitions, lfb is 
the largest free block in decimal words, and tps is the total 
pool space in decimal words. 


The SHOW MEMORY command (Section 8.1.9) displays considerably 
more information about the pool. 
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SHOW LIBRARY 
SHOW USERS 


/SECONDARY._ POOL . 


The ‘SHOW SYSTEM/SECONDARY_ POOL Pecan “on. “ RSx- Fimo pLos S 
isplays: information about secondary pool. The: = tESEIay is 
following formats. ECE SE SE Saag ene he 


— free is. the. “amount 


8. i. oe SHOW LIBRARY 


ahs ‘SHOW LIBRARY command 
RSX-1IM-PLUS.. systems. 
directory: rarely has © 


eee but: the: libiaes 
ite is: as UFD.. ws me 


8.1.8 SHOW USERS 


SHOW USERS* on. RSX-11M systems. displays” he terminal. number and: login 


UIC for all logged-in users. 


SHOW USERS on RSX-11M-PI e terminal number, login 
UIC, and. default UFD- £0 
‘is: supported and is. ‘rut 
date: and time -of- ‘log 
and the user name -of the 


IM-PLUS- Saas shows che 
. tive on” the gece 
Format 

SHOW USERS 
Examples 


SHOW USERS 


TTOt oo) £39549 
ETr2y 5 2 07 v407 
TTS? £3017370) 
TIPE es E 200519 


TT16¢ C7242] 
TTS1? C7 9263 
TTS4$ C303954 
HT23 077433 


This example shows the SHOW USERS display for an RSX-11M system. 
The first column identifies the terminal. The second column is 
the login UIC for nonprivileged users and the current UIC for 
nonprivileged users. HT2: is a DECnet host terminal. 
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SHOW USERS (Cont.) 


»SHOW USERS ~ Sot eee sree sora 
aes (peda: : wie din Sete eerie ccs 
“ts e173707- ei rte tees nae aaa 
oo 


—— 51 Sead SOL ie cote 


yt “RSX-11M-PLUS: 
system. “SE ERORES “Résouree. Seenuant tage “aoe cos ees first: column= 
identifies the terminal. The second column ds the default - SUED cco 


‘Column, 3 Ese Zee LOseR UEC. doibadend mgr a DECnet ‘h Beret iat Pe 
> SHOW USERS Capea ee es os 
“TTLOL f30a052. Stang vee best DRE TERS 
MEIGS 3 B27 259 Ps ROR: 
FALSE ERs Ll oe Ee, Qo is COLIRELL 
TIPS Po ooS RSL 4s SS27 CP! Ege oe 
TTL? C72407 — 0 BR. AMBER 
TIZOR CET F049 ne Fs LTERERWIRTH 
TT2143 C196] 1 ie BROWN 
TT273 L303723 0 Be MABRY 
TT302 [303510] 0 lL. SWEENEY 
TT32: C30t+119 i J, PAINTER 
VAR? Pater 0. J. KASSON 
TT343 £1924) 0 E, BAATZ 
TT35:3 EZ0113703 ct BOLGE 
TT36: [7302] oe ALAMS 
TT373 C303114) 1 Js MORAN 
PTALT SO SL S08 PERT “30 Ce FOOTECOLE 
TT423 C304,325) 325: Oo. Py. BEZEREDI 
TT433 C3037 257-0 LF0R% es J. PETERSON 
TTAS} L724) Py! 0 J. KAUFFMAN 
caTT4O DONE 29 OL TO LTO 0 Ey POLLACK. 
PLA Oe PSA a SOEF OF ing BH Bs ABRAMSON 
ser PESO" C3017356) Poe ce deo PRONE SONS: 
SEPSLL SE ZOARS 79 L304 Senay Oe OTR CARMAN 
ka cee ‘[sosvs) E30 cee “NOV #82, BO CSET PARMENTER 
‘this example gives. the SHOW USERS udisplage. ne: RSX-11M- PLUS. 


system with Resource Accounting. “The first cotann identifies’the . 
iser's TI:, the second column is the current: default -UFD, the ~~ 
cCotanih isthe login UIC, the fourth column gives” the date. 
ie of: login, the fifth column: Tso the: “number: of tasks. 
active, and».the — gixth— <column is the user name... If 
counting. is not. active-or- running at the time of login, 
ast three columns. are not displayed. The user on TT16: in 

example logged in. when Resource’ Accounting. was notvactives 0). 
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SHOW MEMORY 


8.1.9 SHOW MEMORY 


SHOW MEMORY invokes the Resource Monitoring Display (RMD), a system 
utility program. This program displays in a graphic manner the status 
of much of the system. It is, in effect, a display of the contents of 
the system pool (dynamic storage region). 


The RMD program is useful for monitoring the general activity of the 
system. It is also useful viewing for a new user to see how the 
operating system operates. However, you should understand that the 


graphic display is approximate and cannot be used _ for critical 
measurement. 


Format 
SHOW MEMORY 
Example 


“SHOW MEMORY 


OW MEMORY display for | RSX-11M. 
explanation. 


o | 
— RSX-11M V4.0 BLS? . (QUASAR) : Oe aici. 12-MAR-81, 10359114 
6] TASK= KTDLEX @OrFR SY0718470. ° DB2714542, 


NB1162322..° DB3:DMO : PARS 


© P00 =1686 6231686155. 


1686.33168+355." CEXPARSC 
“ TTPAR 3T 
TOMDD °F LPRO- DIRCOM?C.. 
TICRED C POMM SYSPAR?T 
® SERRE OS 10DG ~ . TKNPAR? T° > @® 
hohe Goins, Boles, LE. = 2) -DRVPARSD 
i: a “ty Me LORPAR!T 
Me $ Os BASIC2: 
TOM) dab tbe bape fe a : FOCSRES?C 
OSES 200K 6 4K 6 IOC 28 IIIT 6 OKI L 9 2A 2AKKKEK TSTPARST 
E-P+CT-TH-€=C-T See Sn Pea Pan ee ee @ EN in 
25.6100002 3B 100 X32 020000 3S 2200003 8 40004 1 64 4 BIO AB OIE 
o * ERRSEQ 


ZK-288-81 


The following: éxample~ shows the “SHOW MEMORY - ~ display - “for 
RSX- 11M-PLUS. The circled numbers are keyed OU: he explanation. 
Some numbers appear-on the “RSX= LIM- PLUS “example only.” et 
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SHOW MEMORY (Cont.) 


a RSX 11M-PLUS V2 BLio. (CASTOR) “S1TOK.s UP. 900100249. pees e-TEC-81 161251 53. 
ce TASBE PIPHI | a ree O FREE: SYOt16954.. DRIS0MO. 
ae 3 “DROte755«_ _DE2?0M0 Spots “PARS. 
=170.11494.174. ee a.) SECPOOL= nae giants 25% Pros Senos WO urs 


; | mea neces = CORPARED 
“RCIMTTFSZ BPR RR RR NNE F LNNG 


“wo ee LNNQ BR A OP. 
“C FB -° DORSTTOYZ YMM MM MM TTC. 1 PTEM AT <0 0. 
RRO  offtiCtO0SZ ERD DH IM ..S 1 0.16 Foo. 0 4 
Me AE A ey O-LLY-VSU EA UVOPNF A DA. 0 UL AS 
ge ahs Bo M01 183 MC 64 C85 OL e Oa eae 
ne ere Bt 0%) -0P 0 RPL Po XP. Qs igs 
a : uf ae soe oe Pb bee can ated dames: : 


ZK-287-84 


Operating system type, version number, and base level. 


© 6 


Six-character name that is a DECnet node name (if DEcnet is 
running on your system) or the system name that you 
selected in SYSGEN (if DECnet is not running on your 
system). 


Size in K words of the system memory. 


For RSX-11M-PLUS systems, + ime el uni ts 


hours, and minutes ‘Since t 


of: days, 


Current date and time. 


BT wee af 


eo 60 


7 ”~ 
L 


executing, *IDLE* pee etaeas the "dale loop). 


Number of free blocks on four Files-l1l devices in your 
system. If a device is dismounted, RMD displays "DMO." If 
a device is off line, RMD displays "OFL." 


Pool (dynamic storage region) information in the format: 


© 


POOL=X: Y:Z 
X Number of words in the largest free block in pool 
Y Number of free words in pool 
Z Number of free words in pool 


The second line records the worst case of pool since you 
invoked RMD, This line is most useful if RMD has been 


running on a slaved terminal since the system was last 
hooted. 
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SHOW MEMORY (Cont.) 


‘ago 


On RSX-11M-PLUS systems, secondary po 


“information in the - 


fs 


“Number of free blocks 


10) Partitions in the system using the format: 


partitionname:type 


@ Number of tasks in memory and amount of memory they use and 
number of active tasks swapped or checkpointed out of 
memory and the amount of memory they would require. 


@ Name of each task, common, or driver in memory and its 
location in memory using the following symbols to designate 
Size, type (task, common, or driver), and other attributes: 


Symbol Attribute 


< > Active task 

[ ] Task not active but occupies memory 

! ! Named common 

+ + Unnamed common (displayed name is first 
attached task) 

( ) Loaded driver using device mnemonic 

----- Task not fixed in memory 

=sSs5 Task fixed in memory 


The hyphens and equal signs represent the amount of memory 
that each task, driver, or common occupies. Where the 
display shows only one delimiter and no hyphens or equal 
Signs, the open delimiter is in the same location as the 
closing delimiter of the preceding task. 


SYSTEM CONTROL 


SHOW MEMORY (Cont.) 


Notes 


@® partition size and location. The beginning of each 
partition is marked with the same symbols as those listed 
previously plus the following additions for both operating 
systems: 


E Executive 
P Pool 


The lines of asterisks are proportional representations of 
the amount of memory occupied by each partition. The 
numbers are in 1K-word increments. Each numerical 
character also represents the same amount of memory as an 
asterisk. 


@ System error count Sequence recorded by the Error Logger 
(always zero if Error Logger not present in your system). 


RMD must be installed under the name ...RMD for this command to 
work. 


RMD adjusts its display to your terminal model. If you are at a 
video terminal, the display changes as you watch it. If you are 
at a hard-copy terminal, a snapshot of the display as of the 
moment you issued the command is printed on your terminal. 


Often, RMD is set running on a slaved terminal near the computer 
as part of the system boot procedure. 


Task locations and sizes displayed by RMD should be considered 
approximate. RMD is primarily designed to provide a visual 
display and system debugging tool. It does not measure task size 
or location accurately. 


In general, RMD is designed to allow either an operator or user 
to view the current state of the operating system. The 
information is presented in a graphic, easily comprehensible 


form. 


There are a number of specific instances in which RMD can help to 
locate certain system lockout problems or bugs in application 
and/or system-level software: 


e Bugs and other situations that cause exhaustion of system 
dynamic memory (resulting in unexplained system hangs) 
may be detected and more easily reproduced and diagnosed. 


e Task checkpointing and swapping can be monitored and, in 
systems with limited memory, deadlock conditions can 
often be diagnosed more easily. 


e Free space on a number of Files-1ll devices may be 
monitored in real time, which may help in situations 
where on-line storage is at a premium or where some 
Program is running wild. 


8-12 


SYSTEM CONTROL 
SHOW MEMORY (Cont.) 


Other pages in the RMD display are invoked by the SHOW 
TASKS/DYNAMIC command (Section 7.12.3.3). Once you have started 
the RMD display by either SHOW TASKS or SHOW MEMORY, you can move 
from page to page without issuing any more DCL commands. In 
fact, RMD is meant to enable you to watch the activity in memory, 
on the active task list, and within a single task header and to 
note the relation between these pages. See the RSX-11M/M-PLUS 
System Management Guide for a full explanation of all the 
functions of RMD and for descriptions of the commands used within 
RMD to change from page to page. 


CHAPTER 9 


QUICK REFERENCE 


This chapter lists all DCL commands in alphabetical order. Each 
command entry includes cross-references to the full command 
description in this manual or to other RSX-1LIM/M-PLUS manuals. Each 
command entry also includes a general description of the functions of 
the command, as well as the full command syntax, sometimes with brief 
comments behind an exclamation point (!). 


These command descriptions are intended for quick reference only. Lc 
you are not familiar with the functions of a particular command, you 
should read the main text referenced in this chapter. The comments 
are in shorthand form and are meant to serve as reminders only. 


Comments include examples of input, value ranges, and cautions. 
Privileged commands and qualifiers are flagged as are commands 
‘availa yy RSX-1IM-PLUS «only. =A number of commands have two 
qualifiers listed as synonyms. Other qualifiers perform no operation 
by themselves and are listed in the comments as "no-ops." These 
Synonyms and no-ops are usually included for compatibility with DCL on 
VAX/VMS systems or for clarity and completeness. See the main text 
for more information. 


This chapter does not document the differences between DCL commands as 
used interactively and DCL commands as used in RSX-11M-PLUS batch 
processing. Nor does it provide descriptions of the batch-exclusive 
commands, which are not part of the DCL command set. See the 
RSX-11M/M-PLUS Batch and Queue Operations Manual for descriptions of 
these commands. This chapter also lists and summarizes the DCL 
commands used in setting up the Queue Manager. The RSX-11M/M-PLUS 
System Management Guide includes full details on using these commands. 


For your convenience, some frequently used commands have brief forms. 
These short forms are not necessarily compatible with other 
implementations of DCL and are provided for the convenience of 
RSX-11M/M-PLUS users. They are: 


A ABORT H HELP 

B BROADCAST ie HELP 

Cc COPY LO LOGOUT 
D DIRECTORY L LINK 
DEA DEALLOCATE M MACRO 
DEAS DEASSIGN P PRINT 
E EDIT R RUN 

F FORTRAN S SHOW 


QUICK REFERENCE 


ABORT 


ABORT forces an orderly end to a running task or to the 
Nonprivileged users can abort any task running on 
a eee RSX- “LIM-PLUS | can. abort Ete task coe Heros tne: 


specific command. 


Vite 


Section 7.3 


action of a 


ABORT [/COMMAND] [/qualifier[s]] commandname 

ABORT/TASK[/qualifier] taskname 

Command Qualifiers 

/ COMMAND !Default 

TN i nh ay a NA ts gaa eer aoa teil del 
f/TERMINAL:ttnn: =. IPrivileged; RSX-11M-PLUS only 

/ [NO] POSTMORTEM 

ALLOCATE Section 5.4 
ALLOCATE declares a specified device to be a private device. If you 
omit the unit number and colon, the first available device of that 


class is allocated. 


ALLOCATE[/qualifier[{s]] dd[nn:] [logicalname] 
Command Qualifier 

/TERMINAL:ttnn: !Privileged 
/TYPE: sdevi cetype tRPNG RKNS 


I 


APPEND 


APPEND appends to an aa 
sequential files. 


APPEND[/qualifier[s]] infile[,s] outfile 


Command Qualifiers 


!Logical names same as 
tother device names: 
!'Two characters, octal 
tunit nmumber, and :. 


Section 4.4.3 


sequential file records from one or more 


/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH: dd-mmm-yy 
/SINCE:dd-mmm-yy/ THROUGH :dd-mmm-yy 
/ TODAY 

/EXCLUDE: filespec 


iGiven day only 
!From given day 
!From beginning 
!From given day 
!Today only 


through current day 
through given day 
cheoug given day 


!Filespec can include wildcards. 


QUICK REFERENCE 


ASSIGN Section 5.2 


ASSIGN associates a logical name with a physical device, pseudo 
device, or other logical device. All references to the logical name 
are resolved by the system to the associated physical device, pseudo 
device, or logical device. See also other forms of the ASSIGN command 
described in the following entries. 


ASSIGN[/qualifier[s]] ddnn: logicalddnn: !Logical names same as 
ftother device names: 
'Two characters, octal 
f!unit number, and :. 


Command Qualifiers 


/LOCAL !Default 

/LOGIN !Privileged 

/GLOBAL !Privileged 

/ SYSTEM !Privileged; synonym for /GLOBAL. 
/TERMINAL:ttnn: !Privileged 

ASSIGN/QUEUE 


See the RSX-11M/M-PLUS System Management Guide. 


1) 


ASSIGN/QUEUE establishes a path between a queue and a processor in th 
Queue Manager subsystem. Privileged. 


ASSIGN/QUEUE queuename processorname 
ASSIGN/REDIRECT Section 5.2.1 


ASSIGN/REDIRECT redirects output from one physical device to another. 
You can also redirect output from a physical device to a pseudo device 
or vice versa. Privileged. 


ASSIGN/REDIRECT oldddnn: newddnn: 


QUICK REFERENCE 
ASSIGN/TASK . Section 5.5.2 


ASSIGN/TASK reassigns an installed task's logical unit numbers’ (LUNs) 
from one physical device to another. The reassignment overrides the 
static LUN assignments in the task's disk image file. You cannot 
change the LUNs of an active task. Privileged. 


ASSIGN/TASK:taskname ddnn: lun 


BACKUP Section 5.9 


See also the RSX-11M/M-PLUS Utilities Manual. 


BACKUP backs up and restores Files-1l volumes. It transfers files 
from a volume to a backup volume and retrieves files from the backup 
volume. BACKUP works through the Backup and Restore Utility (BRU). 
You should read carefully the main text entries on BACKUP and BRU 
before using this command. 


BACKUP[/qualifier[s]] sourceddnn:[filespec[s]] destinationddnn: 
Command Qualifiers 
Group 1: Selective Backup and Restore 


/AFTER: (dd-mmm-yy hh:mm) !Use with /CREATED or 

/ BEFORE: (dd-mmm-yy hh:mm) twith /MODIFIED. 

/CREATED 

/ EXCLUDE 

/IMAGEzarg !For multivolume disk operations. 
SAVE 
RESTORE 


/MODIFIED 
/NEW_VERSION 
/ [NO] REPLACE 


Group 2: Initialization 


/ACCESSED:n !n is default number of FCBS per 
!volume. 
/BADBLOCKS:arg !Default 
AUTOMATIC 
MANUAL 
OVERRIDE 
/EXTENSION:n !Default n=5. 
/FILE PROTECTION: code !Default is protection of involume. 
/HEADERS:n 
/INDEX: arg !Specifies location of INDEXF.SYS 
BEGINNING !'on volume; default is location of 
MIDDLE !file on involume. 
END 
n !At logical block n. 


QUICK REFERENCE 


/ INITIALIZE 

/MAXIMUM FILES:n 

/SAVE SET:name !Default is name of volume being 
. !backed up. 

/WINDOWS:n {Default is number of mapping 


{pointers on involume. 


Group 3: Tape and Disk Control 


/ APPEND !May need /REWIND; see main text. 
/DENSITY:arg 

800 

1600 

6250 {Default density is 800 bpi. 
/ERROR LIMIT:n !Default n=25. 
/LABEL: TAPE: fileset-ID 
/LUENGTH:n !Usable length of output tape in 


!decimal feet; default n = physical 
!length of the output tape. 

/REWIND !Rewind first tape of tape set 
!before executing the command line; 
!Imay use with /APPEND. 


Group 4: Verification 


/COMPARE 
/VERIFY 


Group 5: Display 


/LIST 
/ [NO] LOG !/LOG goes to TI:; /NOLOG is default. 


Group 6: Disk Processing 


/DIRECTORY !Can only be used with /NOINITIALIZE. 
/NOINITIALIZE 
/LABEL: arg !See also /LABEL:TAPE:volumelabel, 
!Gp 3. 
INPUT: volumelabel 
(OUTPUT: ] volumelabel !/LABEL: OUTPUT is default; if the 


!only volumelabel in command line 
!is outvolume, /LABEL:volumelabel 


twill do. 
/MOUNTED 
/ [NO] PRESERVE !/PRESERVE is default. 
BASIC Section 6.2.2 


BASIC invokes an interpreter or compiler for the BASIC language. 


BASIC[/qualifier] [@filespec] !@filespec is BP2 only 
Command Qualifiers 
/B11L !BASIC-1l1l 


{/BP2 !BASIC-PLUS-2; the default 
/USING:userbasic 


BROADCAST 


QUICK REFERENCE 


Section 3.6 


BROADCAST displays a specified message at one or more terminals. 


BROADCAST ttnn: message 


BROADCAST @indirectspec 


BROADCAST[/qualifier] message 


Command Qualifiers 


/ ALL 
/LOGGED_IN 


CANCEL 


CANCEL eliminates entries from 
affect a currently executing 


clock queue. 


CANCEL taskname 


COBOL 


COBOL invokes the COBOL-81 


compiler. 


COBOL[/qualifier[{s}} filespec 


Command Qualifiers 


/{NO] ANSI FORMAT 
/ (NO] CHECK: arg 
[NO] BOUNDS 
[NO] PERFORM 
ALL 
NONE 
/CODE: [NO]CIS 
/{NO]CROSS_ REFERENCE 


/ [NO] DEBUG 


/ [NO] DIAGNOSTICS[:filespec] 


/{NOJLIST[:f£ilespec} 
/ NAMES: xx 


BROADCAST username messagé”  "1RSK1IM-PLUS ‘only? no prompt. 


!Privileged 
!Privileged 


Section 7.5 


the clock queue. CANCEL does not 
task, just the pending entries in the 


Section 6.2.4.1 


compiler. COBOL-81 is the default 


!Source is in conventional format. 
!Check ranges of subscripts, 
!indexes, and nested perform 
Istatements at run time. 


!Use CIS in the object code produced. 
!Include cross-reference in listing 
!file. 

!Include Symbolic Debugger in task 
limage. 

!Create a diagnostic file. 

iProduce a listing file. 

!Use two characters you specify as 
!PSECT kernel. 


/ [NO] OBJECT[:filespec] 


QUICK REFERENCE 


!Produce an object module. 


/{NO]OVERLAY DESCRIPTION !Produce indirect command file anda 


/ [NO] SHOW: [NO] MAP 


/{NO] SKELETON 

/ [NO] SUBPROGRAM 
/ TEMPORARY: device 
/ {(NO] TRUNCATE 


!Overlay Descriptor Language file. 
!Produce listfile and append two 
foffset maps. 

!Produce a skeleton ODL file. 
!Treat source file as a subprogram. 
!Store temporary work files. 
!Perform truncation on values of 
!comp data items. 


/ [NO] WARNINGS: [NO] INFORMATIONAL !Issue informational, warning, and 


COBOL/C11 


!fatal diagnostics. 


Section 6.2.4.2 


COBOL/C11 invokes the PDP-11 COBOL compiler. 


COBOL/C11[/qualifier[s] ] 


Command Qualifiers 


/{NO] ANSI FORMAT 
/ [NO] CHECK 


SCL 

/ [NO] CM6 

/{NO]CROSS REFERENCE 
/LARGE SYMBOL TABLE[:n] 
/{NO]LIST[:filespec] 


/NAMES: xx 


/NEST:in 
/(NO]OBJECT[:filespec] 


/ [NO] OVERLAY 
/(NO] POOL LITERALS 
/ [NO] READONLY 


/ [NO] SHOW: (arg[,s]) 


COPY LIST 


MAP 
VERB_LOCATION 


/ [NO] SKELETON 

/ {NO] SUBPROGRAM 
/ TEMPORARY :dev 
/WARNINGS 
/NOWARNINGS 


filespec 


!Source in conventional format; A starts at 8. 
!1/NO means no bounds checking; /CHECK is 
!tdefault. 

!Specifies PDP-11]1 COBOL compiler. 

!/CM6 means COMPUTATIONAL-6. 

!Includes cross-reference in listing file. 
!Allocate more symbol space; n=1-4; default n=l. 
{/NOLIST is default; see main text for 

!filespec defaults. 

!Specify 2-character kernel for program section 
!names. 

!Depth of nested PERFORMS; default=10. 

!/OBJECT is default; see main text 

!for filespec defaults. 

!Make all procedural program sections overlayable. 
!See main text; PDP-11 COBOL documentation. 
!Generate read-only program sections; default 
'is /NOREADONLY or read-write. 

!Specify additions to listing; a single argument 
!needs no parentheses; multiple arguments must be 
!separated by commas and enclosed in 
!parentheses. 

!/NOSHOW:COPY LIST means no source statements 
!from library included in listing. 

!/SHOW:MAP means produce special map. 
1/SHOW:VERB LOCATION means list location for 
teach program verb. 

!Produces skeleton ODL file; default is /SKL. 
!Indicates subprogram. 

!Assigns work files to a specified device. 
!Warning and fatal diagnostics printed 

!Only fatal diagnostics printed 


CONTINUE 


QUICK REFERENCE 


Section 7.4 


CONTINUE resumes execution of a previously suspended task. 


CONTINUE[/qualifier] 
Command Qualifier 


/TERMINAL:ttnn: 


CONVERT 


[taskname] !Taskname defaults to TTnn 


!Privileged; RSX-1L1M-PLUS only. 


Section 4.3.6 


CONVERT invokes the RMSCNV utility, which moves records from one file 


to another. 
to an output file. 


(sequential, relative, 


qualifiers you include with the CONVERT command. See the 
documentation 


and the RMS-11 
information. 


RMSCNV reads records from an input file and writes them 
The action of RMSCNV depends on the 


organization 
and on the 
main text 
system for more 


indexed) of the two files 


supplied with your 


CONVERT [/qualifier[s]] infile outfile 


Command Qualifiers 


/({NO] APPEND 

/BLOCK SIZE:n 

/ [NO] FIXED CONTROL 
/{NO] IDENTIFICATION 


/ INDEXED 
/KEY[:n] 
/{NO]LOG FILE[:filespec] 


TaArAMmOMm 


/{NO] PAD[: [#]arg] 
/RELATIVE 
/ {NO] REPLACE 


/ SEQUENTIAL 
/ [NO] TRUNCATE 


COPY 


COPY copies files. 


Unless specified 


!/APPEND conflicts with /REPLACE. 

!Magtape block size:18<=n<=8192; default=512. 
!/NO is default. 

!'Prints RMS version number; /NO is default; 
Ino filespec required. 

'Outfile is indexed; see main text. 

!0<=n<=9; default=l. 

!1/NO is default; no filespec logs on TI: 


!Both files must have same organization. 

!Pad infile records to outfile length; default 
!pad character is blank (040). 

!Outfile is relative. 

!/REPLACE conflicts with /APPEND. 

!Outfile is sequential. 

!1/NO is default. 


Section 4.3.4 


otherwise, COPY preserves’ the 


file organization of the input file, that is, indexed files are copied 
as indexed files, and so forth. See also the CONVERT command. 


a 


!See main text for multiple file copies 


QUICK REFERENCE 


Command Qualifiers 


/BLOCK SIZE:n !Defines block size for outfile on 
Imagtape; n is octal unless terminated 
!with decimal point; no effect on 


!infile. 
/ [NO] CONTIGUOUS !Specifies contiguous outfile. 
/ OWN !Makes outfile UIC owner of copy. 
/ REPLACE 
/ [NO] SPAN BLOCKS !See main text 
/DATE:dd-mmm-yy !Given day only 
/SINCE:dd-mmm-yy !From given day through current day 
/ THROUGH :dd-mmm-yy !From beginning through given day 
/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy !From given day through given day 
/ TODAY !Today only 
/ EXCLUDE: filespec !Filespec can include wildcards. 
CORAL Section 6.2.5 
CORAL invokes the CORAL 66 compiler. 
CORAL[/qualifier[s]] filespec[,s] 
Command Qualifiers 
/ [NO] CHECK !'Checks boundaries of subscripts and 
Itswitches; default is /NOCHECK. 
/CODE:arg !Specifies choice of instruction set; 
EIS 'default is /CODE:EIS. 
FIS 
FPP 
PIC 
(EIS, PIC) 
(FIS,PIC) 
(FPP,PIC) 
/(NO] EXTEND SOURCE !Processes more than 72 characters or 
- Inot; default is /EXTEND SOURCE. 
/(NO]LIST[:filespec] !Generates listing file or not; 
!default is/NOLIST. 
/ (NO]MACHINE CODE !Listing file includes generated machine 
f!code; default is /NOMACHINE CODE. 
/ NAMES: x !Compiler-generated program-section 
!Inames begin with x; default is S. 
/ [NO] OBJECT[:filespec] !Generate object module or not; 
!'default is /OBJECT. 
/ [NO] OPTIMIZE[: LEVEL: n] !Optimize CORAL 66 source programs; 
!default is /OPTIMIZE. 
/READ_ONLY[:arg] !Alter read-write or read-only attributes 
ALL !of program sections; default is 
NONE !/READ ONLY: PURE DATA. 
PURE DATA 7 = 
/(NO] SHOW[: (arg[,sS])] !Include or exclude elements from 
ALL !listing file; default is /SHOW. 
[NO] EXPANSIONS !'Default is /SHOW:NOEXPANSIONS. 
NONE 
[NO] OVERRIDE !Default is /SHOW:NOOVERRIDE. 
[NO] SOURCE !Default is /SHOW:SOURCE. 
{NO} STATISTICS !Default is /SHOW:STATISTICS. 
{NO] SYMBOLS 'Default is /SHOW:SYMBOLS. 


QUICK REFERENCE 


/ [NO] STANDARD !Highlights non-IECCA keywords or not; 
!default is /NOSTANDARD. 

/TEST[:n] !Retain or omit declarations and 
'statements; default is /TEST:0. 

/ [NO] TRACEBACK !Prints source-file and line-number 


tinformation in run-time messages; 
!'default is /NOTRACEBACK. 

/WIDTH:n !Specifies width of listing file; n = 8 
!through 132; default is /WIDTH:132. 


CREATE Section 4.2.1 


CREATE creates a sequential file in a directory on a file-structured 
device. After you issue the command, you can immediately enter text. 
To end data entry and close the file, type CTRL/Z. See also 
CREATE/DIRECTORY. 


CREATE filespec 
CREATE/DIRECTORY Section 4.2.2 


CREATE/DIRECTORY creates a User File Directory (UFD) on a Files-1l 
volume and enters its name in the volume's Master File Directory 
(MFD). Nonprivileged users can only create directories on mounted 
volumes on their own private (allocated) devices. 


CREATE/DIRECTORY[/qualifier] [ddnn:} [g,m} 


Command Qualifiers 


/ ALLOCATION: n !Entries for n files. 

/ PROTECTION: code 

/LABEL: volumelabel iCompare with volume label. 
DEALLOCATE Section 5.5 


DEALLOCATE counteracts ALLOCATE. It frees a private device for access 
by others. 


DEALLOCATE[/qualifier] ddnn: 'Volume must be dismounted. 


Command Qualifier 


/ ALL !'Frees all devices allocated by TI:; 
!do not specify ddnn:. 

/DEVICE !No-op | 

/TERMINAL: ttnn: oo Privileged; RSX=1LIM-PLUS-only. 


QUICK REFERENCE 


DEASSIGN Section 5.3 


DEASSIGN deletes logical-device assignments. DEASSIGN disassociates 
logical names from physical device names, pseudo device names, or 
logical device names created by ASSIGN. See also other forms of the 
DEASSIGN command described in the following entries. 


DEASSIGN[/qualifier[s]] logicalddnn: 


Command Qualifiers 


/ ALL !Combine with any other qualifier; 
!No ddnn: 
/ LOCAL {Default 
/LOGIN !Privileged 
/GLOBAL !Privileged 
/ SYSTEM !Synonym for /GLOBAL. 
/TERMINAL:ttnn: !Default is TI:; otherwise privileged. 
DEASSIGN/QUEUE 


See the RSX-11M/M-PLUS System Management Guide. 


DEASSIGN/QUEUE counteracts ASSIGN/QUEUE. It is used to eliminate the 
path from a queue to a processor in the Queue Manager subsystem. 
Privileged. 


DEASSIGN/QUEUE queuename processorname 


me : “Section 6 7 5 : = 


DEBUG © pavese: oy “task on ORSX= LIM-PLUS. to ae: eal ae debugger ae Subteing © 
ether. Mabie coin & the task's Processor Status: Word. The: ‘task must have - 
‘been. built using the /DEBUG qualifier to. the LINK command. or have - 
Jesued:. an Executive Gi rective specifying. a debugger. See. main text. 


onprivileged users. can: issue ‘this Samnend: for. any Tonpeiwikeued”: ta 
“running from their own terminals. Privileged users can name any tas 
but “the command must. be issued from the same terminal the bask was. ean 
from. fe pes 


Me 


DEBUG [taskname] 7 | IDefault taskname is ANS: RSX-11M-PLUS 
ea tonly. 


QUICK REFERENCE 


DELETE Section 4.3.2 


DELETE deletes specified versions of files and releases the storage 
Space the files occupy. See also other forms of the DELETE command 
described in the following entries. 


DELETE[/qualifier[s}] ] 


Command Qualifiers 


/ [NO] LOG !Lists deleted files on TI: 
/ [NO] QUERY {Queries before deleting; 

!1/NO is default. 
/DATE:dd-mmm-yy !Given day only 
/SINCE:dd-mmm-yy !From given day through current day 
/ THROUGH: dd-mmm-yy !'From beginning through given day 
/SINCE:dd-mmm-yy/ THROUGH: dd-mmm-yy !From given day through given day 
/ TODAY !Today only 
/ EXCLUDE: filespec !Filespec can include wildcards. 
DELETE/ENTRY 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual. 


DELETE/ENTRY deletes OMG jobs by entry number. 


DELETE/ENTRY:n[/qualifier] In is QMG entry number. 
Command Qualifier 


/FILE POSITION:n 


DELETE/JOB 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual. 
DELETE/JOB deletes QMG jobs by queuename and jobname. 
DELETE/JOB[/qualifier] quevename [[g,m]]jobname 


Command Qualifier 


/FILE POSITION:n 


QUICK REFERENCE 


DELETE/processortype 


See the RSX-11M/M-PLUS System Management Guide. 


DELETE/PROCESSOR deletes print processors, output despoolers, or batch 
processors from the Queue Manager subsystem by processor name or 
device name. This command also sets the device unspooled. 


DELETE/processortype processorname 
APPLICATIONS PROCESSOR 
BATCH PROCESSOR 


CARD READER !INPUT is synonym. 
DEVICE !PRINTER is synonym. 
INPUT !CARD READER is synonym. 
PRINTER IDEVICE is synonym. 
PROCESSOR 

DELETE/QUEUE 


See the RSX-11M/M-PLUS System Management Guide. 


Privileged. DELETE/QUEUE deletes queues in the Queue Manager 
subsystem by name. See DELETE/JOB and DELETE/ENTRY to delete jobs 
from queues. 


DELETE/QUEUE queuename/ERASE !/ERASE is required. 


DIFFERENCES Section 4.4.5 


DIFFERENCES compares two ASCII (text) files line by line to determine 
if parallel records (lines) are identical and produces a listing of 
the differences between the files, if any. 


DIFFERENCES infilel infile2 
Command Qualifiers 


/CHANGE BAR[:n] !n is octal ASCII code of alternate 
tbar. Default n=041 (!). 
/IGNORE: (arg[,Ss]) 
BLANK LINES 


COMMENTS !Comments begin with ";". 
FORM FEEDS 
SPACING !Group of tabs and blanks = 1 blank. 
TRAILING BLANKS 
/LINES:n fi tn lines must be same for match. 
/ [NO] NUMBERS !Line numbers in output file. 
/OUTPUT: filespec !'Names output file; TI: is default. 
/SLP[:audittrail] !Output is SLP indirect command file. 
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QUICK REFERENCE 
DIRECTORY Section 4.3.1 
DIRECTORY displays information on files in directories (UFDs). 


DIRECTORY [/format-qual] [/destination-qual] [other-qual[s]] [filespec[s] ] 


Command Qualifiers 


Format 

/ ATTRIBUTES !RMS-11 attributes 

/BRIEF 

/FREE [ddnn:] !'Free blocks on volume; default is 
1SY:. 

/FULL 

/ SUMMARY !Blocks used and allocated only. 

Destination 

/OUTPUT[:filespec] 'Names output file. TI: is default. 

/ PRINTER !Output to LPO: 

Other Qualifiers !Not used with /FREE or /ATT 

/DATE: dd-mmm-yy !Given day only 

/SINCE:dd-mmm-yy !From given day through current day 

/ THROUGH :dd-mmm-yy !From beginning through given day 

/ SINCE: dd-mmm-yy/ THROUGH: dd-mmm-yy !From given day through given day 

/ TODAY !Today only 

/EXCLUDE: filespec !Filespec can include wildcards. 


DISMOUNT Section 5.7 


nted on the specified device as logically 
m™ the Fila sy 7aktam 


ats rr oo wa at 


DISMOUNT marks the volume mo 
at fr 


OG 


DISMOUNT ddnn: [label] !If label specified, volume label is 
'checked. 


Command Qualifiers 


/ ALL !Dismount all devices mounted by user. 
/PUBLIC !Privileged; dismounts all users from 
!volume. 


SBME SOS NE ES Oe Se BY EL Peged TSK" keeps. spinning; 
tee ana Se meek Ne hae tprivileged tasks can access; © 
CN SR UN ali sh aeiidieal, MM al i co Beg ode sett gee ~ IRSX=1L1IM-PLUS only. | 

/SYSTEM !Synonym for /PUBLIC. 


/ TERMINAL: ttnn: !Privileged; dismounts volumes mounted 
!from another terminal. 


-7(NO] UNLOAD ge oo VAtfects, DBt, DM:, and DU: devices; 
gees Meas - “Isee main text; RSX-1L1M- PLUS only. 


QUICK REFERENCE 


EDIT({/EDT] Section 4.2.3.1 


See also the EDT Editor Manual. 


EDIT or EDIT/EDT invokes EDT, the DEC Standard Editor. EDT is the 
default editor. 


EDIT(/EDT] [/qualifier[s]] filespec 
Command Qualifiers 
/ [NO] COMMAND[:filespec] !Default is /COMMAND:EDTINI.EDT. 


/ [NO] JOURNAL[:filespec] 
/(NO] OUTPUT[:filespec] 


/{NO]READ ONLY !Default is /NOREAD ONLY. 
/ [NO] RECOVER !1Default is /NORECOVER. 
EDIT/SLP Section 4.2.3.2 


See also the RSX-l11M/M-PLUS Utilities Manual. 


EDIT/SLP invokes the Source Language Input Program (SLP), a 
program-maintenance editor. 


EDIT/SLP[/qualifier[s]] filespec 


Command Qualifiers 


/(NO] AUDIT[: (arg[s])] !Default is /AUDIT: (POS:80:SIZ:8). 
POSITION:n tn must be <=132. 
SIZE:n !n must be <14. 


/CHECKSUM[:n] 
/{NO]LIST[:filespec] 
/ [NO] OUTPUT[:filespec] 


/ [NO] REPORT !Report truncation of lines by audit 
ttrail. 

/ [NO] TAB !tRight-justify with tabs or spaces; 
!1/NOTAB is default. 

/ [NO] TRUNCATE[:n] !/TRUNCATE deletes audit trails and 


!Itrailing characters; optionally 
!truncates text at specified 
thorizontal position. 


EDIT/EDI and EDIT/editor Section 4.2.3.3 


EDIT/EDI invokes EDI, the Line Text Editor. EDIT/feditor invokes a 
user-specified editor (see list below). 


EDIT[/qualifier] [edit-input] !Input accepted by editor 
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Command Qualifier 


/EDI 

/KED 

/K52 

/MAKE 

/MUNG 

/OUTPUT: filespec 


/CREATE 
/SOS 
/TECO 


/USING: yyy 


FIX 


QUICK REFERENCE 


'Line Text Editor. 

!Unbundled KED editor. 

!'vT52 version of unbundled KED editor. 
!Unsupported TECO function. 
!Unsupported TECO function. 

'Use with /KED and /K52 (unbundled 
t'editors). 

!Use with KED and K52. 
{Unsupported Son of Stopgap. 
!Unsupported Text Editor and 
!Corrector. 

!Unsupported user editor. 


Section 7.10 


FIX causes an installed task or region to be loaded and locked into 


memory. Privileged. 


FIX[/qualifier] taskname !Name task or region. 


Command Qualifiers 
/ READONLY SEGMENT 


/REGION 


FORTRAN 


Read— 


only segment of 3 | 
er task; RSX-11IM-PLUS only; 
_ region; RSX-11M-PLUS only. 


Section 6.2.3 


FORTRAN invokes a FORTRAN compiler. 


hy 


Command Qualifiers 


/ [NO] CHECK 
/CODE: arg 

EAE 

EIS 

FIS 

THREADED 
/CONTINUATIONS:n 
/ {NO] DLINES 
/ [NO] EXTEND SOURCE 
/FOR t 
/FA4P 
/ [NO] F77 
/IDENTIFICATION 
/(NO]14 
/ [NO] LINE NUMBERS 
/(NO]LIST[:filespec] 


ORTRAN[/qualifier[s]]} 


filespec[s] 


!F4P and F77; default is /NOCHECK. 
!FOR only; mutually exclusive options. 
!Extended Arithmetic Element. 
!Extended Instruction Set. 

!Floating Instruction Set. 


!F4P and F77; n=0-99 continuation lines. 

!D-lines compiled or not. 

!FIV and F77; accept more than 72 columns or not. 
!Code is FORTRAN-IV; default. 

{Code is FORTRAN-IV-PLUS. 

!Code is FORTRAN-77; /NOF77=/F4P. 

iCompiler and version. 

!/NOI4 is default; 14 is 2-word variables. 
!FORTRAN Internal Sequence Numbers. 

!Default is /NOLIST. 


QUICK REFERENCE 


/{NO]MACHINE CODE 


/ {NO]MAP 
/{NOJOBJECT[:filespec] !/OBJECT is default. 
/SHAREABLE !F4P and F77. 
/ SOURCE 
/{NO]STANDARD:arg !ANSI standard extensions; default is 
ALL ! /NOSTANDARD. 
NONE 
SOURCE 
SYNTAX 
/ [NO] TRACEBACK: arg !1F4P and F77. 
ALL !LINES is synonym. 
BLOCKS 
LINES iALL is synonym. 
NAMES 
NONE 
/USING: usercompiler 
/ [NO] VECTORS !FOR only; default is vectored arrays. 
/ [NO] WARNINGS !FOR only; default is warning diagnostics. 
/WORK_FILES:n !F4P and F77; n is maximum for temporary files. 


HELP Section 3.5 


Help displays information about your system. Help files for MCR, DCL, 
and most utilities are supplied with the system. Your system may also 
have help for an alternate CLI or local, group, or other special help. 
See main text. 


HELP[/qualifier[{s]] [parameterl ...parameter9] 


Command Qualifiers 


/OUTPUT: Filespec !'Help text to file; default /OUTPUT:TI:. 
/LOCAL !'Help file is in default UFD; HELP % is same. 
/ GROUP !dHelp file is in [g,1l1]; g is your group. 
/CLI:cliname {For alternate CLIs. 

/MCR !MCR help; default for MCR terminals. 

/DCL !DCL help; default for DCL terminals. 

/FILE: filespec !Names file containing help text. 

/filename !'LB: [1,2] filename.HLP 

HOLD/ENTRY 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual. 


HOLD/ENTRY holds a QMG job in its queue by entry number. 


HOLD/ENTRY:n tn is QMG entry number. 


HOLD/JOB 


QUICK REFERENCE 


See the RSX-11M/M-PLUS Batch and Queve Operations Manual. 


‘ HOLD/JOB holds a QMG job in its queue by queuename and jobname. 


HOLD/JOB queuename [[g,m]]jobname 


INITIALIZE 


INITIALIZE produces a 


Section 5.8 


in Files-1ll format. See also 


INITIALIZE/UPDATE. ~ You (must mount the volume =/FOREIGN on 
-RSX-1IM-PLUS. You.can mount the volume /FOREIGN on RSX-11M, but it is. 


not required. See main text. 


See also other forms of the INITIALIZE 


command described in the following entries. 


INITIALIZE[/qualifier[s] ] 


Command Qualifiers 
/ACCESSED:n 


/BAD BLOCKS:arg 
~- AUTOMATIC 
MANUAL 
OVERRIDE 
/DENSITY:arg 
800 
1600 
6250 
/EXTENSION:n 


/FILE PROTECTION: (code) 


/HEADERS:n 
/ INDEX: arg 
BEGINNING 
MIDDLE 
END 
n 
/MAXIMUM FILES:n 
/OWNER: [g,m] 
/ PROTECTION: (code) 
/ [NO] SHOW 


/WINDOWS:n 


volumelabel !Nonprivileged must 
!allocate the device. 


tNumber of UFDs accessed simultaneously. 


'Default 

!Extend full files by n blocks; 
'default n=5. 

tDefault protection for files 
fon volume. 


!Locates index file on volume. 
!Default for tapes and DECtapes. 
!Default for disks. 


!At logical block n. 


!Default protection for volume. 
!Display volume information on TI:; 
!1/NO is default. 

!Mapping pointers to file windows; 
!default n=7. 


QUICK REFERENCE 


INITIALIZE/PROCESSOR (Output) 


See the RSX-11M/M-PLUS System Management Guide. 


INITIALIZE/PROCESSOR creates, names, and starts an output despooler or 
batch processor. Privileged. See next entry to initialize an input 
spooler. 


INITIALIZE/processortype processorname[/qualifier[s]] 
Processortypes: 


APPLICATIONS PROCESSOR 
BATCH PROCESSOR 

DEVICE 

PRINTER 

PROCESSOR 


Command Qualifiers 


/FLAG PAGE:n In can be 0-2; default n=l. 
/FORMS:n !n can be 0-255; default n=0. 
/ [NO] SHAREABLE 'Default is NOSHAREABLE. 

/ [NO] LOWERCASE !Default is LOWERCASE, 

/ [NO] UPPERCASE !Default is NOUPPERCASE. 


INITIALIZE/PROCESSOR (Input) 


See the RSX-11M/M-PLUS System Management Guide. 


INITIALIZE/processortype creates, names, and starts an input spooler 
or card-reader processor. Privileged. See previous entry to 
initialize an output despooler. 


INITIALIZE/processortype processorname[/qualifier[s] ] 
CARD READER !INPUT is synonym. 
INPUT !CARD READER is synonym. 


Command Qualifiers 
/BATCH QUEUE: queuename 


/CONSOLE:ddnn: 
/PRINTER QUEUE: queuename 


QUICK REFERENCE 


INITIALIZE/QUEUE 


See the RSX-11M/M-PLUS System Management Guide. 


INITIALIZE/QUEUE creates, names, and starts a 


Manager subsystem. 


INITIALIZE/QUEUE queuvename[/qualifier] 
Command Qualifiers 
/BATCH 


/PRINTER 
/NOWARNINGS 


IDefault 


INITIALIZE/UPDATE 


INITIALIZE/UPDATE invokes the HOME utility to 


volume home block without affecting 


queue 


alter 
the other data on the volume. 


in the 


Section 5.8.1 


values in 


INITIALIZE/UPDATE is only for disks and DECtapes in Files-1ll format. 


You must mount the volume /FOREIGN. on RSX-11M-PLUS.— 
volume /FOREIGN on RSX-1IM, but it is. not required. 


INITIALIZE/UPDATE[/qualifier[s]] ddnn: 
Command Qualifiers 


/ACCESSED:n 
/DENSITY:arg 

800 

1600 

6250 
/EXTENSLONIO 
/FILE PROTECTION: code 
/OWNER: [g,m] 


volumelabel 


Queue 


the 


You can mount. the 
See main text. 


/MAXIMUM FILES:n 

/ PROTECTION: code 

/ [NO] SHOW 

/ LABEL: newvolumelabel 
/WINDOWS:n 


INSTALL 


INSTALL includes a task in the System Task Directory, thus 


!Maximum number of files on volume. 
{Protection for volume. 


!Changes volume label. 
!Mapping pointers to file windows; default n=7. 


Section 7.8 


making it 


known to the system. Privileged. 


INSTALL[/qualifier[s]] [$]filespec 


QUICK REFERENCE 


Command Qualifiers 


/{NO] CHECKPOINT 
/COMMAND: "taskcommand" 


/EXTENSION:n In (octal) additional words of address 
!space. 

/MULTIUSER PARTITION: parname !Install read-only portion. 

/ PARTITION: parname 

/ [NO] POSTMORTEM 

/PRIORITY:n 10-250. 

/ READONLY COMMON !Install common as read-only. 

/ [NO] SLAVE !/NOSLAVE is default. 

/TASK NAME: taskname !1-6 characters. 


/UiC:{fg,m] 


LIBRARY Section 6.3 


See also the RSX-11M/M-PLUS Utilities Manual. 


LIBRARY creates and maintains user-written library files. The command 
has eight functions, each listed here as a separate command. See main 
text for more details on all functions and qualifiers. 


LIBRARY [/operation] [/qualifier[s]] 


LIBRARY @filespec !Indirect command file specification. 
LIBRARY/COMPRESS Section 6.3.1 


LIBRARY/COMPRESS physically deletes modules that have been logically 
deleted through LIBRARY/DELETE. You can rename the resulting 
compressed library. You can also use this command to copy a library 
and rename it. 


LIBRARY/COMPRESS[:(arg[,S])] libspec [newlibspec] 


GLOBAL:n !Entry-point table entries. 

MODULES:n 'Module-name table entries. 

BLOCKS:n !Size in 256-word blocks. 
LIBRARY/CREATE Section 6.3.2 


LIBRARY/CREATE creates a library and optionally inserts one or more 
modules into it. 


LIBRARY/CREATE[: (arg[,s])][/qualifier[{s]] libspec [infilespec[s] ] 


GLOBAL:n !Entry-point table entries. 
MODULES:n !Module-name table entries. 
BLOCKS:n !Size in 256-word blocks. 
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QUICK REFERENCE 


Command Qualifiers 


/ {NO]GLOBALS !Include globals in entry-point table. 
/MACRO !'Identifies macro library. 

/OBJECT !Default; identifies object library. 
/SELECTIVE SEARCH !Object modules only. 

/ SQUEEZE 

/ UNIVERSAL !Identifies universal library. 
LIBRARY/DELETE Section 6.3.3 
LIBRARY/DELETE deletes object modules from a library. See 


LIBRARY/REMOVE for removing global symbols (entry points) froma 
library. 


LIBRARY/DELETE libspec module[,module[,s] !Name as many as 15 modules 
LIBRARY/EXTRACT Section 6.3.4 


LIBRARY/EXTRACT reads one or more modules from a library and writes 
them to a specified output file. You can extract as many as eight 
modules with a single command. If you extract more than one module, 
the modules are concatenated in the output file. 


LIBRARY/EXTRACT[/qualifier] libspec module[,s] 


Command Qualifier 


/OUTPUT[:filespec] 'Default output file is TI:; name 
!a file when extracting object 
!modules. 

LIBRARY/INSERT Section 6.3.5 


LIBRARY/INSERT inserts modules from one or more files into a library. 


LIBRARY/INSERT libspec filespec[s] !Name any number of files 
Command Qualifiers 
/ [NO] GLOBALS !Include globals in entry-point table. 


/SELECTIVE SEARCH 
/ SQUEEZE 


QUICK REFERENCE 


LIBRARY/LIST Section 6.3.6 


LIBRARY/LIST lists on your terminal or in an output file the names of 
all modules in a library. 


LIBRARY/LIST[:filespec] libspec 


Command Qualifiers 


/BRIEF 

/ FULL 

/ {NO] NAMES !Names plus global entry points. 
LIBRARY/REMOVE Section 6.3.7 


LIBRARY/REMOVE removes global symbols (entry points) from a library. 
See LIBRARY/DELETE for deleting object modules from a library. 


LIBRARY/REMOVE libspec global[,global[,s] !Name as many as 15 global symbols 


LIBRARY/REPLACE Section 6.3.8 


LIBRARY/REPLACE replaces a module in a library with a new module of 
the same name and deletes the old module. 


LIBRARY/REPLACE libspec filespec[s] 


Command Qualifiers 


/ {NO] GLOBALS !Include globals in entry-point table. 
/SELECTIVE SEARCH 
/ SQUEEZE 


LINK Section 6.4 


LINK invokes the Task Builder, which links object modules and routines 
from user and system libraries to form an executable task. 


LINK[/qualifier[s]] filespec[/qualifier[s]][,filespec[s] ] 


Command Qualifiers 


/ ANCILLARY PROCESSOR[:n] 
/BASIC ~ 
/ (NO]CHECKPOINT:arg 
SYSTEM 
TASK 
/CODE: (arg[,s] ) 
DATA SPACE SOO 
EAE 
FPP 
PIC 
POSITION INDEPENDENT 
/COMPATIBLE 7 
/{NO]CROSS REFERENCE 
' / [NO] DEBUG[: filespec] 
/ [NO] EXECUTABLE: filespec 
/ERROR_LIMIT:n 
~-Z (NO] EXTERNAL 
/FAST 
/FULL SEARCH 
/ {NO] HEADER 
/(NO]IO PAGE 
/LONG ~ 
/MAP([:filespec] 
/ [NO]MEMORY MANAGEMENT [:n] 


/OPTIONS[:filespec]} 
/OVERLAY_ DESCRIPTION 
/ POSTMORTEM 
/ [NO] PRIVILEGED[ :n] 
/ [NO] RECEIVE 
/(NOIRESIDENT QVERLAYS 
/ SAVE 7 
/SELECTIVE SEARCH 
/ [NO] SEGREGATE 
/ SEQUENTIAL 
/ SHAREABLE[:arg] 

COMMON 

LIBRARY 
/ SLAVE 
/ SLOW 
/SYMBOL TABLE{:filespec] 
/ [NO] SYSTEM LIBRARY DISPLAY 
/ [NO] TASK[:filespec] 


/TKB 
/ TRACE 
/ [NO] WARNINGS 


/WIDE 

File Qualifiers 
/ [NO] CONCATENATE 
/DEFAULT LIBRARY 
/ {NO} GLOBALS 


/ LIBRARY 
/ INCLUDE: (modulel[:...:modulen] ) 


/OVERLAY DESCRIPTION 
/SELECTIVE SEARCH 


QUICK REFERENCE 


!Task is ACP; n is 0,4, or 5. 


{Checkpoints to [0,0]CORIMG.SYS. 
!Checkpoints to task image file. 


YRSXSVIMCPLUS “onl ys! 


!Extended arithmetic element. 
{Floating-point processor. 
!Position-independent code. 
{Synonym for PIC. 


!Default is ODT. 
!Names task file. Synonym for /TASK. 
!Stop task build after n errors. 


” IRSX-11M-PLUS only. 


!Fast TKB. 


{Long map 
!Default is /MAP:TI: 
!n for unmapped systems; see main 


ttext; default is /MEM; n is 28 (default) or 30. 


!File contains options. Otherwise you will be prompted 


!Default is /NOPRIVILEGED. 


!Saves indirect file. 
!/NOSEG is default. 


!Multiuser 


RSX-11M-BLUS only 


{Slow TKB. 

!Output .STB file 

!Default is /NOSYS. 

!Names task image file; /EXECUTABLE 
!is synonym; names 1-6 characters; 
1/NOTASK means no task built. 
{Default 


!1/NO suppresses diagnostic messages; /WARNINGS 
!default. 
!Wide map 


1File to replace [1,1[SYSLIB.OLB 
!Default is /GLOBALS; includes 

!global symbols in map. 

!File is object module library. 

!File is object module library; 

!include named modules in task image. 
!File is .ODL; also a command qualifier. 
!Also a command qualifier. 


is 


QUICK REFERENCE 
LINK/C81 or LINK/COBOL Section 6.4.3 


LINK/C81i invokes the Task Builder and the COBOL BLDODL facility, and 
indicates that COBOL-81 object modules are being linked. 


LINK/C81[/qualifier[s]] filespec[,s] 

LINK/COBOL[/qualifier[s]] filespec[,s] 

Command Qualifiers 

/ [NO] FMS {/FMS:NORESIDENT equivalent to /FMS. 
/OTS: [NO] RESIDENT 

/ [NO] RMS 

/ RMS: [NO] RESIDENT 


/ [NO] MAP 
/ [NO] DEBUG 


LOGIN Section 3.1.1 


LOGIN (or HELLO) grants access to a multiuser protection system and 
establishes your privileges as a system user. 


LOGIN userid password IHELLO is synonym. 
LOGOUT Section 3.1.2 


LOGOUT counteracts LOGIN. LOGOUT also aborts any nonprivileged tasks 
running from the terminal and also dismounts any volumes. and 
deallocates any private devices allocated from the terminal. 


LOGOUT [/qualifier] ILO is sufficient 
Command Qualifier 


/ [NO] HOLD !Holds remote line after logout; /NO 
tis default. 


MCR Section 1.2.4 


MCR enters an MCR command from a DCL terminal without leaving DCL. 


MCR mcrcommand 


QUICK REFERENCE 


MACRO 


MACRO invokes the MACRO-11 Relocatable Assembler, which assembles 
or more MACRO-11 source files into a single relocatable object module 


Section 6.2.1 


suitable for processing by the Task Builder. 


MACRO[/qualifier[s]] filespec[/qualifier[s]][,filespec[,s] ] 


Command Qualifiers 


/{NO]CROSS_ REFERENCE 
/DISABLE: (arg[,s]) 
ABSOLUTE 
BINARY 
CARD FORMAT 
GLOBAL 
LOCAL 
LOWERCASE 
REGISTER DEFINITIONS 
TRUNCATION 
/ENABLE: (arg[,$]) 
ABSOLUTE 
BINARY 
CARD FORMAT 
GLOBAL 
LOCAL 
LOWERCASE 
REGISTER DEFINITIONS 
TRUNCATION 
/ [NO] LIST[:filespec] 
/{NOJ]OBJECT[:filespec] 
/ {NO} SHOW[: (arg[,s])] 
ALL 
BINARY 
CALLS 
COMMENTS 
CONDITIONALS 
CONTENTS 
COUNTER 
DEFINITIONS 
EXPANSIONS 
EXTENSIONS 
LISTING DIRECTIVES 
OBJECT BINARY 
SEQUENCE NUMBERS 
SOURCE ~— 
SYMBOLS 
/(|NO]WIDE 


File Qualifiers 


/LIBRARY 
/PASS:n 
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!Default is /NOCROSS. 
!Parentheses not required 
!if single parameter; see 
Imain text for meaning of 
!parameters. 


!Parentheses not required 
!if single parameter; see 
imain text for meaning of 
!parameters. 


{Default is /NOLIST. 
'Default is /OBJECT. 
!Parentheses not required 
!if single parameter; see 
!Imain text for meaning of 


!parameters. ALL is default. 


!File is macro library. 


!Assemble file on pass 1 or 2. 


QUICK REFERENCE 


MOUNT Section 5.6 


MOUNT declares a volume to be logically known to the system, on iine, 
and available for use. Some qualifiers can be used with any MOUNT 
command; some are limited to mounting disks (and other 
random-addressable devices) and others are limited to mounting 
magnetic tapes. 


Format for Disks and Other Random-Addressable Devices 
MOUNT[/qualifier[s]] ddnn: volumelabel 

Format for Magnetic Tapes 

MOUNT[/qualifier[{s]] ddnn:[,ddnn:...] fileset-ID 
Command Qualifiers for Both Disks and Tapes 


TOES arg 


~ SAVE. 
“NOUNLOAD - 

: “UNLOAD © ee wee ee ne ee Be hi bre oe sng ng Se 
/PILE PROTECTION: eeeen !Protection for files created during mount 
/ FOREIGN 
/OVERRIDE: IDENTIFICATION !Privileged; no label needed. 

/PARAMETERS: "user parameters" !Quotes are required syntax. 
/ PROCESSOR: arg !Privileged; name ACP for volume. 
acpname 
UNIQUE[:acpname] 
/ PROTECTION: (code) {Volume protection during mount 
/PUBLIC !Privileged; deallocates; sets public. 
/ [NO] SHAREABLE 
/ (NO] SHOW !Display volume information on TI:. 
/SYSTEM !Synonym for /PUBLIC. 
/(NO]WAIT !Default is /NOWAIT. 


/{NO] WRITE 


Command Qualifiers for Files-ll Devices 


/ACCESSED:n !n is number of File Control Blocks. 
/EXTENSION:n !Extend full files by n blocks. 

/OWNER: [g,m] !Coordinate with file and volume protection 
/ UNLOCK !Main use is with VFY. 

/WINDOW:n 


Command Qualifiers for ANSI and Unlabeled Tapes 
See main text for these qualifiers. 


/BLOCK SIZE:n 
/CARRIAGE CONTROL:arg 


FORTRAN 
LIST 
NONE 
/DENSITY:arg 
800 
1600 
6250 


QUICK REFERENCE 


/ [NO] HDR3 
/ [NO] LABEL 
/ OVERRIDE: (arg[,s]) 
ACCESSIBILITY 
EXPIRATION DATE 
SET IDENTIFICATION 
/RECORD SIZE:n 
/TRANSLATE:arg 
EBCDIC 
NONE 
UTIL 
UT2 
UT3 
/VOLUME IDENTIFICATION: (volume-ID[,volume-ID[,s]]) 


PRINT Section 4.4.2 


PRINT queues files for printing on a line printer. PRINT can also 
queue jobs for other output devices. 

PRINT[/qualifier[s]] filespec[/qualifier[s]][,filespec[,s]] 

Command Qualifiers 


/AFTER: (dd-mmm-yy hh:mm) 


/COPIES:n !Override on filespec. 

/ [NO] DELETE !Override on filespec. 

/DEVICE:ddnn: 

/{NO]FLAG PAGE !Flag page on each file; default is 
7 !/NOFLAG PAGE. 

/FORMS:n In can be 0-256; default n=0. 

/{NO]HOLD !Default is /NOHOLD; same effect as 


!HOLD command. 
/JOB_COUNT 
/[NO}JOB_ PAGE !Flagpage on job; default /JOB PAGE. 
/LENGTH:n !Page length = 
/ [NO] LOWERCASE 
/ NAME: jobname !l- 
_A{NOVTRANSPER OU nd ee HOverride*on filesre 
/PAGE COUNT:n iLimit pages in job. 
/PRIORITY:n !n is 1-150 nonprivileged; through 250 
!privileged; default n=50. 


9 characters 


aredaa An £99 esnec. . 


Beg 


/QUEUE: queuename 
/ [NO] RESTART 
/ {NO] UPPERCASE 


File Qualifiers 


/COPIES:n 
/({NO]DELETE _ 
_/ [NO] TRANSFER 


QUICK REFERENCE 


PURGE Section 4.3.3 


PURGE deletes all but the latest versions of files and releases the 
storage space the deleted files occupy. 

PURGE[/qualifier[s]] filespec[s] 
Command Qualifiers 

KEEPin 
/ [NO] LOG I1Lists files on TI: as deleted. 
/DATE:dd-mmm-yy !Given day only 
/SINCE:dd-mmm-yy !From given day through current day 
/ THROUGH :dd-mmm-yy !From beginning through given day 
/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy !From given day through given day 
/ TODAY !Today only 
/ EXCLUDE: filespec !Filespec can include wildcards. 
RELEASE/ENTRY 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual. 


RELEASE/ENTRY releases by entry number a print or batch job that has 
been held in its queue. 


RELEASE/ENTRYin In is QMG entry number. 


RELEASE/JOB 


See the RSX-11M/M-PLUS Batch and Queve Operations Manual. 


RELEASE/JOB releases by gqueuename and jobname a print or batch job 
that has been held in its queue. 


RELEASE/JOB queuename [[g,m]]jobname 
REMOVE Section 7.9 


REMOVE counteracts INSTALL. REMOVE takes a task name out of the 
System Task Directory. Privileged. 

REMOVE[/qualifier] taskname 

Command Qualifier 

‘ifakes name.of region out .- 


lof Common Block Directory and . 
tpartition list; RSX-11M-PLUS ‘only. 


/REGION | 
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QUICK REFERENCE 
RENAME Section 4.3.5 


RENAME changes the name, type, or version number of an existing file. 


RENAME[/qualifier[s]] oldfilespec newfilespec !tWatch wildcards and version numbers. 


Command Qualifiers 


/DATE:dd-mmm-yy !Given day only 

/SINCE:dd-mmm-yy !Prom given day through current day 
/ THROUGH: dd-mmm-yy !From beginning through given day 
/SINCE:dd-mmm-yy/ THROUGH :dd-mmm-yy !From given day through given day 

/ TODAY !Today only 

/ EXCLUDE: filespec !'Filespec can include wildcards. 
REQUEST Section 3.7 


REQUEST sends a message to the operator's console (CO:). 


REQUEST message !Optional "quotes" around message 
RUN uninstalled task Section 7.2.1 


When used to run an uninstalled task (from a task image file), RUN is 
a combination command, encompassing INSTALL, RUN, and REMOVE. See 
main text. 


RUN[/qualifier[s]] [$]filespec 
Command Qualifiers 


/ [NO] CHECKPOINT 


/COMMAND: "taskcommand" !See main text. 
/EXTENSION:n !'n (octal) additional words of address 
!space. 
/ PARTITION: parname !Privileged 
/ [NO] POSTMORTEM 
/PRIORITY:n !Privileged 
/STATUS:arg 
TASK 
COMMAND 
/ TASK NAME: eee ame ee eee aia 11-6 Characters | 


TIME” LIMIT: eetol” Para SS PALO PSM: Omrinutes): : 

nent | SEES NS Lt bye d tau bts cal aise be = eaghandars 
re ei lag Pa engi a ag ~IRSX-LIM-PLUS only. 3M is default. 
/UIC: {g,m] iPrivileged. 


RUN 


QUICK REFERENCE 


installed task Section 7.2.2 


RUN also initiates the execution of installed tasks. Privileged users 
can use RUN to initiate the execution of installed tasks on a schedule 
by creating entries in the system clock queue. 


RUN[/qualifier[{s]] taskname 


Command Qualifiers !All privileged except /STATUS 


/DELAY:nu !'n is the number of units and u is the 


ftime unit: T,ticks; S,Seconds; 
!M,minutes; H,hours. 


/ INTERVAL: nu 
/SCHEDULE:hh:mm:ss 
/STATUS:arg 
COMMAND 'Return status from RUN command; default. 
TASK !Return status from task being run; 
!see main text on both these 
farguments. 
/SYNCHRONIZE:u !Synchronize on next T, S, M, or H. 


/UIC: [g,m] 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


[DAY] TIME Section 8.1.1 


[DAY] TIME sets the system date and time. Privileged. 


[DAY] TIME: [dd-mmm-yy] [hh:mm] !Set at least one; either order. 
DEFAULT Section 4.5.1 


DEFAULT establishes your default device or UFD, or both. 


DEFAULT[:ddnn:] {{g9,m]] 'Unadorned SET DEF returns 
!nonprivileged user to login device 
!and UFD. 

DEVICE Section 5.10.2 

DEVICE establishes certain device attributes. Privileged. 


DEVICE:ddnn:/qualifier{[s] 


QUICK REFERENCE 


Command Qualifiers 


/ [NO] CHECKPOINT FILE[:n] In is number (decimal) of blocks in 
. !{0,0]CORIMG.SYS. 

/ [NO] LOWERCASE !Default is /NOLOWERCASE. 

/ {NO] PUBLIC !Default is /NOPUBLIC. 

/WIDTH:n !'Nonprivileged for TI:. 

SET GROUPFLAGS Section 6.6.1 


SET GROUPFLAGS creates and deletes group global event flags. See main 
text. 


SET GROUPFLAGS:n[/qualifier] !Nonprivileged command for own group 
!n is group number. 
Command Qualifiers 


/CREATE !Default 
/ DELETE 


. Section. 8.1.4 


SET LIBRARY/DIRECTORY 


SET LIBRARY/DIRECTORY establishes the SX-11M-PLUS directory where the 
system. utilities and other nprivileged system tasks are kept. 
Privileged. Pee on és 


SET LIBRARY/DIRECTORY:[g,;m] {Does not create a directory.) 9 
SET [NO] PARTITION Section 7.12.1 
SET [NO] PARTITION creates or eliminates a partition. Privileged. 


SET [NO] PARTITION: parname/qualifier[s] !Parname 1-6 characters 


Command Qualifiers 


/BASE:n 

PROMUMON Ooo OE Sea See oe Ee TR SKE TEM Only 
/DEVICE !Device common. 
{DIAGNOSTIC 2 Ste TREK T Me PLUS. only. 
/SIZE:n 

of (NO]SUBPARTITION: subparname. ~~ IRSX-IT1IM only. 
/SYSTEM 

PEAS R 8 ee Oe Soa ee Se ORE R a LLM On by 
/TOP: value 


QUICK REFERENCE 


SET PRIORITY Section 7.12.8 


SET PRIORITY alters the priority of an active task. Privileged. 


SET PRIORITY:n taskname tn = 0 through 250 


SET PROTECTION Section 4.5.3 


SET PROTECTION establishes the protection status of files. 


SET PROTECTION: code[/qualifier{s]] filespec[s] !The preferred syntax; 


SET PROTECTION[/qualifier[s]] filespec[s] (code) !tdefault is (SY:RWED,OW:RWED,GR:RWED,W:R). 


Command Qualifiers 


/ DATE: dd-mmm-yy !Given day only 

/SINCE:dd-mmm-yy 1From given day through current day 
/ THROUGH: dd-mmm-yy 'From beginning through given day 
/SINCE:dd-mmm-y y/THROUGH :dd-mmm-yy !'From given day through given day 

/ TODAY !Today only 

/ EXCLUDE: filespec !Filespec can include wildcards. 


SET QUEUE/ENTRY 


SET QUEUE/ENTRY modifies by entry number some attributes of print or 
batch jobs once they are in a queue. See SET QUEUE/JOB to modify by 
job name. 


SET QUEUE/ENTRY:n[/qualifier] !Only one attribute at a time 
Command Qualifiers 


/ AFTER: (dd-mmm-yy hh:mm) 

/COPIES:n 

/ [NO] DELETE 

/FILE POSITION:n 

/EORMS:n 

/HOLD !Same as HOLD/QUEUE 
/LENGTH:n 

/ {NO] LOWERCASE 

/PAGE COUNT:n 


/PRIORITY:n In is 1-150 nonprivileged; through 250 
!privileged; default n=50. 
/ RELEASE !Same as RELEASE/QUEUE 


/(NO]RESTART 
/(NO] UPPERCASE 


QUICK REFERENCE 


SET QUEUE/JOB 


eee 


SET QUEUE/JOB modifies by job name some attributes of print or batch 
jobs once they are in a queue. See SET QUEUE/ENTRY to modify by entry 
number. 


SET QUEUE/JOB[/qualifier] quevename [[g,m]]jobname 
!Only one attribute at a time 


Command Qualifiers 


/ AFTER: (ddd-mmm-yy hh:mm) 

/COPIES:n 

/(NO]DELETE 

/FILE POSITION:n 

/FORMS:n 

/ HOLD !Same as HOLD/QUEUE 
/LENGTH:n 

/ [NO] LOWERCASE 

/PAGE COUNT: n 


/PRIORITY:n tn is 1-150 nonprivileged; through 250 
Iprivileged; default n=50. 
/RELEASE !Same as RELEASE/QUEUE 


/ [NO] RESTART 
/ [NO] UPPERCASE 


SET SYSTEM Section 8.1.3 


SET SYSTEM establishes certain characteristics of the system. It is a 
privileged command. 


SET SYSTEM/qualifier {Qualifier required 


Command Qualifiers 


/DIRECTORY: (g,m] !Sets UFD where system tasks are kept; 
!does not create a directory. 
/EXTENSION LIMIT:n !Sets maximum size a task can extend 


ltitself with the Extend Task 
!directive. 
/ [NO] LOGINS 


/ PACKETS:n tn = 0 through 15 
/POOL: top:max:total !Increases size of pool; see main 
text. 2 


QUICK REFERENCE 


SET TERMINAL Section 3.8.1 


SET TERMINAL sets various attributes of your terminal. Privileged 
users can set attributes for any terminal. 

SET TERMINAL[:ttnn:]/qualifier([s] 

Command Qualifiers 


Group 1: Common Use 


/DCL 

/(NO]HOLD SCREEN INot for vT100s 

/ [NO] LOWERCASE !1/NOLOWER same as /UPPER and is 

/MCR 'default. 

/ [NO] PRIVILEGED !Privileged 

/SPEED: (transmit,receive) !Remember to set hardware after this 
!command. 

/ [NO] UPPERCASE 1/NOUPPERCASE same as /LOWERCASE 

/WIDTH:n 

/ [NO] BROADCAST 

/CLI:cliname 

Group 2: Terminal Setup 

/ [NO] AUTOBAUD 

/ASR33 

/ASR35 

/CRFILL:in 'n can be 0-7 


/(NO] FORM FEED 
/ [NO] HARDCOPY 
/KSR33 
/KSR35 
/LA12 
/LA30P 
/LA30S 
/LA34 
/LA36 
/LA38 
/LALOO 
/LA120 
/LA1L80S 
/LFFILL 
/{NO] SCOPE 
/ [NO] TAB 
/MODEL:arg 
/PAGE LENGTH:n 
/VTO5 — 
/VT50 
/VT52 
/VT55 
/VT61 
/VT100 
/VT1O1 
/VT102 
/VT105 
/VT125 
/VT131 
/VT132 
/WIDTH:n 


QUICK REFERENCE 


Group 3: Task Setup 


7 {NO] ECHO 
/({NO] EIGHT BIT 
/(NO] ESCAPE 
/(NO]FULL DUPLEX 
/{NO] INTERACTIVE 
/ [NO] LOCAL 

/ {NO] PASSALL 
/(NO] REMOTE 
‘7 {NO] SERIAL 


/{NO] SLAVE es 
/ [NO] TYPEAHEAD[ in] = 


/ [NO] WRAP 


SHOW ASSIGNMENTS Section 5.10.1 


SHOW ASSIGNMENTS displays at your terminal your local and _ login 
logical-device assignments. Privileged users can display assignments 
from other terminals and global assignments. 


SHOW ASSIGNMENTS [/qualifier[s] ] 


Command Qualifiers 


/GLOBAL !Privileged 

/ LOCAL !Default 

/ LOGIN !Same as /LOCAL 

/SYSTEM !Synonym for /GLOBAL; privileged. 
/ TERMINAL: ttnn: !Privileged. 


QUICK REFERENCE 


SHOW CLOCK QUEUE Section 7.12.9 


SHOW CLOCK QUEUE displays information about tasks currently in the 
clock queue. This information consists of the task names, the next 
time each task is to run, and each task's reschedule interval, if any. 


SHOW CLOCK QUEUE 


2 


“RSX-11M 


SHOW [DAY] TIME Section 8.1.2 


SHOW [DAY]TIME displays the system time and date setting. 


SHOW [DAY] TIME 


SHOW DEFAULT Section 4.5.2 


SHOW DEFAULT displays the current default device and UFD for your 
terminal, along with your terminal number. 


SHOW DEFAULT 


SHOW DEVICES Section 5.10.3 


SHOW DEVICES displays information about the devices included in the 
system. 


SHOW DEVICES[/qualifier] !Two-character mnemonic only 


QUICK REFERENCE 


Command Qualifiers 
/dd{[nn: ] 
/{NO] PUBLIC 


/WIDTH:ddnn: 
/{NO] SYSTEM !Synonym for /PUBLIC 


SHOW GROUPFLAGS Section 6.6.2 
SHOW GROUPFLAGS displays the group global event flags currently in the 
system. 


SHOW GROUPFLAGS 


SHOW MEMORY Section 8.1.9 


SHOW MEMORY invokes the Resource Monitoring Display (RMD), a dynamic 
display of the system's activities in memory. 


SHOW MEMORY 


SHOW PARTITIONS Section 7.12.2 


SHOW PARTITIONS displays address and content information about’ the 
partitions in the system. You can display information about all 
partitions or about a single partition. 


SHOW PARTITIONS[:name] 


QUICK REFERENCE 


SHOW PROCESSOR 


See the RSX-l11M/M-PLUS Batch and Queue Operations Manual. 


SHOW PROCESSOR displays information about the processors, batch 
processors, printers, card readers, and other devices under control of 
the Queve Manager. Batch processing is available on RSX-11M-PLUS 
only. 


SHOW processortype processorname 


Processortypes: 


CARD READER !INPUT is synonym. 

DEVICE !All nonbatch output processors; 
!tsynonym for PRINTER. 

INPUT !CARD READER is synonym. 

BATCH !All batch processors; RSX-11M-PLUS 
tonly. 

PRINTER !All nonbatch output processors; 
!synonym for DEVICE. 

PROCESSOR 

SHOW QUEUE 


See the RSX-11M/M-PLUS Batch and Queue Operations Manual. 


SHOW QUEUE displays information about batch and print jobs in queues. 
Batch processing is available on RSX-11M-PLUS only. 


SHOW QUEUE[/qualifier] [queuename] 


Command Qualifiers 


/ALL !All entries in all queues 
/BATCH !All entries in all batch queues; RSX-11M-PLUS 
lonly. . 
/BRIEF 
/DEVICE !All nonbatch queues; synonym for /PRINTER. 
/ENTRY:n 
/FILES !Lists files in each job; not as long 
las /FULL. 
/EORMS:n 
/FULL 
/ NAME: jobname !Lists only jobs with that name; may 
Ibe more than one. 
/OWNER UIC: [[g,m]] !Lists only jobs from that UIC; 
!default UIC is login UIC. 
/PRINTER {All nonbatch queues; synonym for 
!/DEVICE. 


QUICK REFERENCE 


SHOW SYSTEM Section 8.1.6 


SHOW SYSTEM displays information about the current system. 


SHOW SYSTEM[/qualifier] 


Command Qualifiers 


/CLI !CLIs on current system 

/DIRECTORY !Default; displays current system UFD. 
/EXTENSION LIMIT !Task extension limit 

/PACKETS — !Maximum I/O packets and number 


!currently available. 
!Displays pool statistics 


Ook 


SHOW TASKS Section 7.12.3.1 
Tel2ese2 


SHOW TASKS displays information about active or installed tasks. 


SHOW TASKS[:taskname] /qualifier[s] 
Command Qualifiers 


/ACTIVE[:ttnns: ]} 

/ INSTALLED 

/LOGICAL UNITS 'Static LUNs for installed task 
=. Iqualifier. 

/BRIEF 

/ FULL 

/ALL 


SHOW TASKS/DYNAMIC Section 7.12.3.3.l 
Tel2vsesen 


SHOW TASKS/DYNAMIC invokes RMD to display on a video terminal 
continuing changes in either a single task header or of all or part of 
the Active Task List. On a hard-copy terminal, SHOW TASKS/DYNAMIC 
provides a snapshot display. See main text for more information. 


Format to display individual task information 
SHOW TASK: taskname/DYNAMIC[/qualifier] 
Command Qualifier 


/RATE:n !Rate in seconds for display change; default n=l. 


QUICK REFERENCE 


Format to display Active Task List 
SHOW TASKS/ACTIVE/DYNAMIC[/qualifier{[s]] 


Command Qualifiers 


/OWNER: ddnn: !'Default is ALL. 

ALL | 
/PRIORITY:n !Highest priority to display; default n=250. 
/RATE:n !Rate in seconds for display change; default n=1. 


SHOW TERMINAL Section 3.8.2 


SHOW TERMINAL displays information about your terminal and other 
terminals on your system. 


SHOW TERMINAL[:ttnn:][/qualifier] !Without qualifier, displays all 
lattributes of the terminal; 
!default ttnn:=TI:. 


Command Qualifiers 


/ [NO] AUTOBAUD 
/{NO] ASR33 

/ [NO] ASR35 

/ [NO] BROADCAST 
/CLI:cliname 
/{NO]CRFILL 

/DCL 

/ {NO] ECHO 

/({NO] EIGHT BIT 

/ [NO] ESCAPE 
/{NO]FORM FEED 
/(NO]FULL DUPLEX 
/ {NO] HARDCOPY 
/[NO]HOLD SCREEN 
/HT !DECnet host terminal 
/{NO] INTERACTIVE 
/ [NO] KSR33 

/ [NO] KSR35 
/{NO]LAL2 
/{NO]LA24 

/ [NO] LA30P 

/ [NO] LA30S 

/ [NO] LA34 

7 [NO] LA36 

/ [NO] LA38 
/{NO]LALOS 

/ {NO]LA120 
/{NO]LA180S 

/ {NO] LFFILL 

/ [NO] LOCAL 


/LOGGED_ON 

/ [NO] LOWERCASE !NOLOWER same as /UPPER and is 
!default. 

/MCR 

/MODEL 


/PAGE_ LENGTH 
/ [NO] PASSALL 


QUICK REFERENCE 


/ [NO] PRIVILEGE 

/{NO] REMOTE 

/ [NO] SCOPE 

/ [NO] SERIAL 

/ [NO] SLAVE 

/ SPEED 

/ [NO] TAB 

FTI: !All real terminals 

/TT 

/ [NO] TYPE AHEAD !/NO UPPERCASE same as /LOWERCASE. 


/(NO] VTO5 
/ [NO] VT50 

/{NO] VT52 

/ [NO] VT55 

/{NO]VT61 

/ [NO] VT100 
/{NO]VT1O1 
/ {NO] VT102 
/{NO] VT105 
/(NO] VT125 
/{NO]VT131 
/{NO] VT132 
/WIDTH 

/ [NO] WRAP 


SHOW OSERS Section 8.1.8 


SHOW USEPS displays all currently logged-in terminals, including 
DECnet host terminals and virtual terminals, with the default UFD and 
login UIC for each. 

SHOW USERS 

SORT Section 4.4.4 


SORT invokes the SORT-1l utility, if present. See main text. 


SORT[/KEY: (abm.n) [abm.n...]] [/qualifier[{s}] infile[/qual] outfile FORMAT: (arg) [/qual] 
Command Qualifiers 


/ALLOCATION:n 
/BUCKET SIZE:n 
/ {NO] CONTIGUOUS 
/DEVICE:ddnn: 
/ PROCESS: type 
ADDRESS ROUTING 
INDEX 
RECORD 
TAG 
/SIZEin 
/SPECIFICATION: filespec 
/WORK FILES:n 


QUICK REFERENCE 


File Qualifiers 


/BLOCK SIZE:n !Infile or outfile 
/EORMAT: (format, [n]) !Required on infile; may appear on 
foutfile; n is size in bytes. 
FIXED:n 
STREAMin 
UNKNOWN:n 
VARIABLE:n 
/INDEXED:n !Infile 
/ RELATIVE !Outfile 
/ SEQUENTIAL !Outfile 
START Section 7.7 


START resumes execution of a task stopped by a STOPSS directive. 


START[/qualifier] [taskname] !Taskname defaults to TTnn. 
Command Qualifier 


/ TERMINAL: ttnn: !Privileged 


START/PROCESSOR 

See the RSX-11M/M-PLUS System Management Guide. 

START/PROCESSOR starts a processor, batch processor, output processor, 
or card-reader processor. Privileged. 

START/processortype processorname[/qualifier[s] ] 


Processortypes: 


APPLICATIONS PROCESSOR 
BATCH PROCESSOR. 


CARD READER !INPUT is synonym. 
DEVICE !PRINTER is synonym. 
INPUT !CARD READER is synonym. 
PRINTER !IDEVICE is synonym. 
PROCESSOR 


Command Qualifiers 


/FORMS:n !Overrides value set on 
finitialization. 

/CONTINUE _1Default 

/RESTART 

/NEXT 

/TOP OF FILE 

/BACKSPACE:n 

/ FORWARDSPACE:n 

/PAGE:n 

/ ALIGN 


QUICK REFERENCE 
START/QUEUE 
See the RSX-11M/M-PLUS System Management Guide. 
START/QUEUE starts a queue. Privileged. 
START/QUEUE queuename 
START/QUEUE/MANAGER 
See the RSX-11M/M-PLUS System Management Guide. 
START/QUEUE/MANAGER starts the Queue Manager. Privileged. 


START/QUEUE/MANAGER 
START/UNBLOCK Section 7.7.1 


START/UNBLOCK continues the execution of a task blocked by the 
STOP/BLOCK command. Nonprivileged users can unblock any task running 
from their own terminal. Privileged users can unblock any task. See 
main text. 


START/UNBLOCK[/qualifier] [taskname] 


Ce : m ind Qualifie 


STOP/ABORT 


See the RSX-1L1IM/M-PLUS Batch and Queue Operations Manual. 


STOP/ABORT stops the current job on a line printer immediately. 
Privileged users can stop any job. Nonprivileged users can stop their 
own jobs. 


STOP/ABORT printer[:] 


QUICK REFERENCE 
STOP/BLOCK Section 7.6 


STOP/BLOCK blocks an installed running task. The task no longer 
executes or competes for memory. Nonprivileged users can block tasks 
running from their own terminals. Privileged users can block any 
task. See main text. 


STOP/BLOCK[/qualifier] [taskname] 


STOP/PROCESSOR 
See the RSX-11M/M-PLUS System Management Guide. 


STOP/PROCESSOR stops a processor, batch processor, card-reader 
processor, printer, or other output processor. Privileged. 


STOP/processortype processorname[/qualifier[s] ] 

Processortypes: 
APPLICATIONS PROCESSOR 
BATCH PROCESSOR. 

CARD READER ! INPUT is synonym. 

DEVICE ! PRINTER is synonym. 

INPUT !CARD READER is synonym. 

PRINTER !DEVICE is synonym. 

PROCESSOR 


Command Qualifiers 


/ABORT !See main text 
/FILE_END 

/JOB_END 

/ PAUSE 


STOP/QUEUE 
See the RSX-11M/M-PLUS System Management Guide. 
STOP/QUEUE stops queues. Privileged. 


STOP/QUEUE queuename 


QUICK REFERENCE 


STOP/QUEUE/MANAGER 


See the RSX-11M/M-PLUS System Management Guide. 


STOP/QUEUE/MANAGER stops the Queue Manager. Privileged. 


STOP/QUEUE/MANAGER !Marks QMG for stop after current job. 


Command Qualifier 


/ ABORT !Stops QMG immediately. 


| /AETER: (danny rm aaa ae 
/TNOTDELERE Le. after run; command 
-/{NO] HOLD 


/ [NO] LOG FILE 
/NAME: jobname 


/ {NO} PRINTER[:q 


/QUEUE:queuenam 
/{NO] RESTART 
-/ [NO] TRANSF 


TYPE Section 4.4.1 


TYPE prints selected files on your terminal. 


TYPE [/qualifier[s]]filespec[s] 


/DATE:dd-mmm-yy !Given day only 

/SINCE:dd-mmm-yy !1From given day through current day 
/ THROUGH :dd-mmm-yy !From beginning through given day 
/SINCE:dd-mmm-yy !From given day through given day 

/ TODAY !Today only 


/ EXCLUDE: filespec 
!Filespec can include wildcards. 


QUICK REFERENCE 


UNF IX 


UNFIX frees a fixed task or region from memory. 


UNFIX[/qualifier] taskname 


Section 7.1ll 


Privileged. 


!Can be region name. 


UNLOCK 


UNLOCK unlocks locked files. 
improperly closed. They are 
listing. 


UNLOCK [/qualifier[s]] filespec[s] 
Command Qualifiers 


/DATE:dd-mmm-yy 

/SINCE:dd-mmm-yy 

/ THROUGH: dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm~yy 
/ TODAY 

/EXCLUDE:filespec 


Section 4.4.6 


Locked files are files that have been 
identified by an L in the directory 


!Given day only 

!From given day through current day 
!From beginning through given day 
!From given day through given day 
!Today only 

!Filespec can include wildcards. 


APPENDIX A 


COMMON ERROR MESSAGES 


The following error messages are common to many DCL commands. They 
may appear on your terminal preceded by a 3-letter code identifying 
the system component that detected the error. This can be DCL or the 
first three letters of the command itself. This code appears here as 


YYY- 


Most of the error messages with the word "expected" in them reprint 
the command on your terminal with a circumflex (*) pointing to the 
error. Sometimes the circumflex points to the character just past the 
last successfully parsed command element. 


Many of the explanations refer to the Radix-50 character set. The 
Radix-50 characters are the uppercase alphabet, the numerals 0 through 
9, the dollar sign (S$), and the period (.). 


Many other error messages are included in the descriptions of the 
commands that produce the errors. Many system tasks also issue error 
messages. These messages are explained elsewhere in the documentation 
set. In particular, many I/O errors return error messages as code 
numbers. These errors are explained in the system Mini-Reference and 
are discussed further in the I/0 documentation. The RSX-11M/M-PLUS 
MCR Operations Manual and the RSX-11M/M-PLUS Utilities Manual also 
contain explanations of many errors. ©. 


yyy -- Allocation failure - no contiguous space 


Explanation: Not enough contiguous space is available on _ the 
output volume for the file being copied. 


User Action: Delete any files no longer required on the output 
volume and retry the command. You may need to use the BACKUP 
command or the DSC utility to compress the files on the output 


disk. 
~.yyy -- Allocation caine on output file 
or 
yyy -- Ailocation failure -- no space available 


Explanation: Not enough space is available on the output volume 
for the file being copied. 


User Action: Delete any files no longer required on the output 
volume and retry the command. You may need to use the BACKUP 
command or the DSC utility to compress the files on the output 
disk. 


be 4 


YYY 


YYY 


YYY 


YYY 


bee § 


YY Y 


YYY 


COMMON ERROR MESSAGES 


-- A-Z expected 


Explanation: The command as typed included a nonalphabetic 
character. 


User Action: Check command for proper syntax and reenter. 
-- A-Z and/or 0-9 expected 


Explanation: The command as typed included a nonalphanumeric 
character. 


User Action: Check command for proper syntax and reenter. 
-- Bad error message 

Explanation: Some unusual condition has caused an error. 

User Action: Notify your operator or system manager and make 
ready to send in a Software Performance Report (SPR). Record the 
command that caused the error and other information on activity 
at your terminal at the time. 


-- Bad use of wild cards in destination file name 


Explanation: A wildcard (*) was specified for an output file 
where it is not permitted. 


User Action: Reenter the command with a complete and explicit 
file specification for the output file. 


-- Cannot find directory file 


Explanation: The command specified a UFD not found on the 
current volume. 


User Action: Reenter the command after checking for the correct 
UFD and correct volume. 


-- Cannot find files 


Explanation: The file or files specified in the command are not 
in the designated directory. 


User Action: Check the file specification and reenter the 
command line. 


-- Cannot rename from one device to another 


Explanation: The command attempted to rename a file across 
devices. 


User Action: Use the COPY command to move the file from one 
device to another and rename it. 


-- Cannot truncate this filetype 
Explanation: The command attempted to truncate a file that 
cannot be truncated. Only files containing fixed-length, 


variable-length, or sequenced records can be truncated. 


User Action: Check to see if you have named the proper file and 
retry the command. 


YY 


VY 


YyYY 


Ley 


yyy 


yVY 


YVV 


vYY 


¥VY 
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-- Close failure on input file 
or 
-- Close failure on output file 


Explanation: A file named in the command could not be properly 
closed. The file is locked by PIP. 


User Action: Use UNLOCK to unlock the file. Determine the cause 
of the error and correct it if you can. You may need to check 
the validity of the file structure with the VFY utility. 


-- Command function not unique 


Explanation: The command as typed did not include sufficient 
characters to identify some command function. 


User Action: Retype command after checking proper syntax. 
-- Command line incomplete 

Explanation: The command as typed is not a complete command. 
User Action: Retype command after checking proper syntax. 

-- Command syntax error 

Explanations The command did not conform to the syntax rules. 
User Action: Check command for proper syntax and reenter it. 
-- Conflicting qualifier 


Explanation: The command as typed included qualifiers that 
conflict with each other in their effect. 


User Action: Retype command after checking proper syntax. 
-- Contradictory qualifier 


Explanation: The command as typed included contradictory 
qualifiers, sucn as /DELETE and /NODELETE. 


User Action: Check for proper syntax and reenter command. 
-~- Contradictory qualifier in key specification 


Explanation: The command included a contradictory qualifier in 
the key definition argument to the /KEY qualifier. 


User Action: Check command for proper syntax and reenter. 
-- Decimal number expected 
Explanation: The command included a number not in proper format. 


User Action: Check command for proper syntax and reenter with a 
decimal point (.) terminating the number. 


COMMON ERROR MESSAGES 


yyy -- Device invalid or not specified 


Explanation: The command specified an invalid device or no 
device at all when a device name is required. 


User Action: Check the devices on the system with SHOW DEVICES. 
Reenter command after checking for proper syntax. Determine the 
cause of the error and correct it if you can. If you cannot, see 
your operator or system manager. 


yyy -- Device not in system 


Explanation: The command specified a device that is not in the 
current system. 


User Action: Check the devices on the system with SHOW DEVICES. 
Reenter command after checking for proper syntax. 


yyy -- Device not mounted/allocated 


Explanation: The command specified a device that is not properly 
mounted or allocated for the command to execute. 


User Action: Check the status of the device with SHOW DEVICES. 
Find the cause of the error and correct it if you can. It is 
likely that you will need to mount the volume on the device. 
Nonprivileged users need the volume label to mount the volume. 


yyy - Device not terminal 


Explanation: The command specified a device other than a 
terminal where a terminal device name is required. TI: is not 
an acceptable terminal device name in all contexts. 


User Action: Reenter the command after checking for proper 
syntax. 


yyy -- Directory write protected 


Explanation: The command attempted to remove an entry from a 
directory that is privileged or from a directory on a device that 
is write-protected. 


User Action: Determine the cause of the error and correct it if 
you can. You may need to enable write access through the device 
hardware or change the protection for the directory. If you 
cannot correct the error, see your system manager or operator. 


yyy -- Error dispatching command. DSW = 'n!' 


Explanation: An error occurred that was not explicitly handled 
by DCL or some invoked task. 


User Action: Look up the DSW error code in the Mini-Reference or 
the RSX-11M/M-PLUS Executive Reference Manual. Determine the 
cause of the error and correct it if you can. If you cannot, see 
your system manager or operator. 

yyy -- Explicit output file name required 
Explanation: The command requires an explicit output file name. 


User Action: Reenter the command line in proper syntax and 
without wildcards. 


YYY 


yyy 


ve'g d 


vy 


yyy 
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-- Extraneous input 

Explanation: The command as typed included extraneous input. 
The circumflex (*) points to the error or just past the last 
successfully parsed command element. 

User Action: Reenter the command line in proper syntax. 

-- Failed to attach output device 

or 
-- Failed to detach output device 

Explanation: An attempt to attach or detach a record-oriented 
output device, Such as a terminal or line printer, failed. This 


error usually means the device is off-line or nonresident. 


User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 


~~ Failed to create output UFD 

Explanation: The command failed to create an entry in a 
directory because the device was write-protected or because of a 
privilege violation. 

User Action: Determine the cause of the error and correct it if 
you can. You may need to enable write access through the device 
hardware or change the protection for the directory. If you 
cannot correct the error, see your system manager or operator. 

-- Failed to delete file 

or 

-- Failed to mark file for delete 

Explanation: The command attempted to delete a protected file. 
User Action: Check for the proper file specification and default 
UFD and reenter the command. You may need privilege to delete 
the file. 


-- Failed to enter new filename 


Explanation: The command specified a file that already exists in 
the UFD, or the directory is protected. 


User Action: Check for proper syntax and reenter the command. 


-- Failed to find files 


User Action: Check for proper file specifications and reenter 
the command. 


COMMON ERROR MESSAGES 


yyy -- Failed to get time parameters 
Explanation: An internal system problem has occurred. 


User Action: Retry the command. If the error recurs, see your 
system manager and prepare to submit a Software Performance 
Report. Record the command that caused the error and other 
information on activity at your terminal at the time. 


yyy -- Failed to read attributes 


Explanation: The command specified a volume that is either 
corrupted or protected against access. 


User Action: You may be able to correct the error by making your 
defaults the same as the device and UFD of the file you wish to 
affect. You may need to check the validity of the volume with 
the VFY utility. 


yYY -~ Failed to remove directory entry 


Explanation: The command attempted to remove an entry from a 
directory that was either protected against access or ona 
write-protected device. 


User Action: Determine the cause of the error and correct it if 
you can. You may need to enable write access through the device 
hardware or change the protection for the directory. If you 
cannot correct the error, see your system manager or operator. 


yyy -- Failed to truncate file 


Explanation: The command specified a volume that is corrupted or 
is protected against access. 


User Action: You may be able to correct the error by making your 
defaults the same as the device and UFD of the file you wish to 
affect. You may need to check the validity of the volume with 
the VFY utility. 


yyy -- Failed to write attributes 


Explanation: The command specified a volume that is corrupted or 
is protected against access. 


User Action: You may be able to correct the error by making your 
defaults the same as the device and UFD of the file you wish to 
affect. You may need to check the validity of the volume with 
the VFY utility. 


yyy -- Fatal I/O error 


Explanation: The command failed to execute because of some I/0 
error. This error can be caused by the unavailability of a 
device or of pool space, or by a device error. The device may be 
write-locked. 


User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 
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-- File is lost 


Explanation: PIP has removed a file from its UFD, failed to 
delete it, and failed to restore the directory entry. 


User Action: Use the VFY utility to run the lost-file check to 
recover the file name. 


-- Filename or filetype not specified 

Explanation: The command as typed did not clearly specify a file 
name and file type where one or the other or both is required. 
This error can be caused if you do not leave a space in front of 
a file specification that is a parameter. 

User Action: Retype command after checking for proper syntax. 


-- File not locked 


Explanation: An UNLOCK command specified a file that is not 
locked. 


User Action: Check for the proper file specification and reenter 
the command. 


-- File specification either invalid or not specified 

Explanation: The system could not read a file specification 
included in the command. This error often results from a typing 
mistake or typing the command in the wrong format. 

User Action: Check for proper syntax and reenter the command. 


-- File specification list not available for RMS-11 


Explanation: A command to an RMS-11 utility included more than 
one input file specification. 


User Action: Check for proper syntax and reenter command. 
-- File version number not specified 


Explanation: The command requires a file version number to be 
specified. 


User Action: Reenter command after checking for proper syntax. 
-- Function not unique 


Explanation: The command as typed did not include sufficient 
characters to identify some function. 


User Action: Retype the command but include more characters. 
-- Get command line - Bad @ file name 


Explanation: The command specified an illegal indirect command 
file. 


User Action: Check for proper file specification and reenter the 
command. 
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-- Illegal command 


Explanation: The command, which is the first word on the command 
line, is not part of DCL. 


User Action: Check command for proper syntax and reenter. If 
the command fails again, see your system manager. 


-- Illegal device 


Explanation: The command named a device in an illegal format or 
contained some other syntax error, 


User Action: Check command for prover syntax and reenter. 
Device names are two alphabetical characters followed by an octal 
number and a colon. 


-- Illegal filespec 


Explanation: The command required a file specification that was 
not present. 


User Action: Check command for proper syntax and reenter. See 
Section 4.1.2 for a complete description of a file specification. 
Perhaps some other command element is being parsed as a filespec. 
Use the prompting version. 


-- Illegal job name 


Explanation: A command to the Queue Manager named a job in an 
improper format. 


User Action: Check command for proper syntax and reenter. Job 


names include an optional UIC and as many as nine Radix-50 
characters. The ich name is listed in the SHOW QUEUE display 


See ae ee 


-- Illegal or contradictory qualifier 


Explanation: One or more qualifiers to the command are in 
conflict, or are in error. 


User Action: Check command for proper syntax and reenter. 
~- Illegal processor name 


Explanation: A command to the Queue Manager named a processor in 
an improper format. 


User Action: Check command for proper syntax and reenter. 
Processor names include as many as six Radix-50 characters. 
Processor names are listed in the SHOW PROCESSOR display. 
-- Illegal protection code 


Explanation: The command specified a protection code in an 
improper format. 


User Action: Check command for proper syntax and reenter. See 
Section 4.1.5 for more information on protection codes. 
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-- Illegal qualifier value 


Explanation: The command as typed included an improper argument 
to a qualifier. 


User Action: Check command for prope ntax and reenter. In 
) 


-- Illegal queue name 


Explanation: A command to the Queue Manager named a queue in an 
improper format. 


User Action: Check command for proper syntax and reenter. Queue 
names include as many as six Radix-50 characters. Queue names 
are listed in the SHOW QUEUE display. 
-~- Illegal use of wildcard character 

Explanation: The command included a wildcard (* or %) ina file 
specification in a way that would result in unpredictable or 
inconsistent output. 


User Action: Check command for proper syntax and reenter. You 
may not be able to use the wildcard. 


-- Illegal task name 


Explanation: The command named a task using a task name in an 
illegal format. 


User Action: Check command for proper syntax and reenter. - Task 
names include as many as six Radix-50 characters. 


-- Input device must be a directory device 

Explanation: The command as typed specified a device that is not 
a directory device, such as a line printer or magnetic tape. 
Directory devices are those on which Files-1l volumes’ with 
directories can be mounted. 

User Action: Correct syntax and reenter command. 


-- Input files have conflicting attributes 


Explanation: Warning message. The command operation completed, 
but the files named had-conflicting attributes. 


User Action: Use DIRECTORY/ATTRIBUTES to find the attributes of 
all input and output files involved. Determine if the conflict 
causes any difficulty. 


-- Invalid command function 


Explanation: The command as typed requested a function that is 
not valid for that command. 


User Action: Check command for proper syntax and reenter it. 
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-- Invalid command parameter 

Explanation: The command as typed included a parameter that is 
not valid. In DCL, a parameter is either entered in response to 
a prompt or preceded by a space. 

User Action: Check command for proper syntax and reenter. 
-- Invalid file specification list 

Explanation: The command included a list of file specifications 
in an invalid format. In general, file specifications in lists 
should be separated by commas and, optionally, blanks. 

User Action: Retype command after checking proper syntax. 
-- Invalid file specification qualifier 

Explanation: The command included a qualifier to a file 
specification that was not valid. In DCL, a qualifier is 
preceded by a slash (/). 

User Action: Check for proper syntax and retype the command. 


-- Invalid terminal specified 


Explanation: A command directed to a specific terminal named the 
terminal in an improper format. 


User Action: Check the name of the terminal using SHOW USERS and 
reenter the command with the proper format. 


-- Invalid time or date 


Explanation: The command specified a clock or calendar field, or 
both, incorrectly. 


User Action: Check for proper syntax and retype the command. 
-- Invalid UIC specified 
Explanation: The command specified a 0, a number including an 8 
or 9, or a number greater than 377 (octal) for the group or 
member number in a UIC or UFD. 
User Action: Retype command after checking for proper syntax. 
-- I/O error on input file 
or 
-- I/O error on output file 
Explanation: One of the following conditions exists: 
e The device is not on line. 
@ The device is not mounted. 
@ The hardware has failed. 
@e The output volume is full. 


e The input file is corrupted. 
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User Action: Determine the cause of the error and correct it if 
you can. If you cannot, see your operator or system manager. 
-- Key position size or number not specified 
Explanation: The command failed to include the size or number of 
a key position in the key definition argument to the /KEY 
qualifier. 
User Action: Check command for proper syntax and retype it. 


-- Key specification out of sequence 


Explanation: The command included improper syntax in the key 
definition argument to the /KEY qualifier. 


User Action: Check command for proper syntax and reenter. 
-- Magnetic tape file label not specified 


Explanation: The command attempted to initialize a magnetic tape 
without specifying the required volume label. 


User Action: Retype command after you have checked for proper 


-- More command parameters than permitted 

Explanation: The command as typed included too many parameters. 
User Action: Check command for proper syntax and reenter. 

-- No such file 


Explanation: The command requested operations on a file that 
does not exist. 


User Action: Make sure you have named the file properly. Check 
your defaults to be sure you are looking in the right UFD on the 
right device. You may have made a typing error. If the desired 
file is in fact not present, find out why it is not present and 
proceed accordingly. 


-- Not a directory device 


Explanation: A directory-oriented command named a device that 
does not have directories, such a line printer. 


User Action: If you can, reenter the command without specifying 
a UFD. 


-- Not logged in 


q 4 
Explanation: A command was entered at a terminal that was not 
logged in. 


User Action: Only LOGIN, HELLO and HELP execute on terminals 
that are not logged in. If you do not know how to log in, type 
HELP. If you know how to log in, do so and reenter the command. 
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-- Numeral expected 
-- Numeral required 


Explanation: Command included nonnumeric characters in a 
position where numerals are required or expected. 


User Action: Check command for proper syntax and reenter. 
-- Octal number expected 


Explanation: The command included a number with an 8 or 9 where 
an octal number was expected. 


User Action: Check command for proper syntax and reenter. 
-- Open failure on file 


Explanation: The system could not open a required file for some 
reason. 


User Action: Check the UFD to be sure that the file is present, 
not locked, and in the proper format. If the file is locked, it 
may be corrupted or contain bad data. Determine the cause of the 
error and correct it if you can. If you cannot, see your 
Operator or system manager. 


-- Output device must be a directory device 
Explanation: The command as typed specified a device that is not 
a directory device, such as a line printer or magnetic tape. 
Directory devices are those on which Files-1l1 volumes with 
directories can be mounted. 
User Action: Correct syntax and reenter command. 

-- Partition busy 
Explanation: The partition into which a task was to be fixed was 
occupied by a running task. The requested task thus could not be 


fixed. 


User Action: Wait until the partition is no longer busy or find 
out why the partition is busy and proceed accordingly. 


-~- Primary key not specified 

Explanation: A command affecting an indexed file failed to 
include a primary key. In many such commands, you cannot specify 
any action on an alternate key without first identifying the 
primary key. 

User Action: Check for proper syntax and reenter command. 


-- Privilege violation 


Explanation: The command was a privileged command issued at a 
nonprivileged terminal. 


User Action: None. If you must have the function requested, 
find a privileged user to issue the command for you. 
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-- Qualifier inconsistent with compiler 
Explanation: A compiier command included a qualifier not 
acceptable by that compiler, such as a FORTRAN/F4P command 
including a /LINE NUMBERS qualifier, which is for the FOR 
compiler only. 
User Action: Check the command for proper syntax and try it 
again. Remember that your command may be specifying a compiler 
by default. 
-- Qualifier not available for this command format 
Explanation: The command included a qualifier that is invalid in 
the current context of the command. The context is usually 
determined by some other qualifier in the command. 
User Action: Reenter command after checking for proper syntax. 


-- Qualifier not unique 


Explanation: The command as typed did not include sufficient 
characters to identify some qualifier. In DCL, qualifiers are 


preceded by a slash (/). 

User Action: Retype the command, but include more characters. 

-- Qualifier value invalid here 

Explanation: The commands as typed included an inappropriate 
argument to a qualifier. In DCL, an argument is usually preceded 
by a colon (:). 

User Action: Check command for proper syntax and reenter. 


-- Radix-50 expected 


Explanation: The command included a non-Radix-50 character where 
Radix-50 required. 


User Action: Reenter the command using proper syntax. The 
Radix-50 characters are the uppercase alphabet, the numbers 0 
through 9, the dollar sign ($), and the period ({.). 


-- Repeated command parameter 


Explanation: The command as typed included one parameter more 
than once. In DCL, a parameter is preceded by a blank or prompt. 


User Action: Retype command after checking for proper syntax. 
-- Repeated key specification 

Explanation: The command as typed included the same key 
specification more than once in the key definition argument to 
the /KEY qualifier. 

User Action: Retype command after checking for proper syntax. 


-- Repeated keyword in key specification 


Explanation: The command as typed included the same keyword more 
than once in the key definition argument to the /KEY qualifier. 


User Action: Retype command after checking for proper syntax. 
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-- Repeated magnetic tape file label 


Explanation: The command included the required volume label more 
than once. 


User Action: Check command syntax for correctness and_ reenter 
the command. 


-- Repeated qualifier 


Explanation: The command specified the same qualifier more than 
once. In DCL, a qualifier is preceded by a slash (/). 


User Action: Reenter command after checking the syntax to see if 
it is right. 


-- Required parameter not specified 


Explanation: The command cannot execute without required 
parameters, such as a file specification or attribute. In DCL, a 
parameter is preceded by a blank or prompt. 


User Action: Retry the command, using the prompts. DCL prompts 
for all required parameters. 


-- Required qualifier not specified 


2$fe: 


Explanation: The command requires a qualifier that it does not 
include. In DCL, a qualifier is preceded by a slash (/). 


User Action: Check for proper syntax and reenter the command. 

-- Required qualifier value not specified 

Explanation: A qualitier to the command requires that you state 
a numerical argument. In DCL, an argument is usually preceded by 
a colon (:). 

User Action: Retype command after checking for proper syntax. 


-- Required value not specified for position size or number 


Explanation: The command failed to include a required value in 
the key definition argument to the /INDEXED qualifier. 


User Action: Check command for proper syntax and reenter. 
-- Sorry, line too long 


Explanation: DCL commands are translated for execution by MCR or 
another system task or utility. This error is caused by a 
translated command line that the destination task cannot handle. 


User Action: Check command syntax to see if you are specifying 
elements that can be defaulted. Check to see if you can enter 
the command twice with different qualifiers to accomplish in two 
commands what you cannot accomplish in one. You may have to 
enter the command in MCR format or the format of the task or 
utility you are seeking to invoke. Check the translated command 
line with SET DEBUG. 


A-14 


COMMON ERROR MESSAGES 


yyy -- Sorry, "“-" not supported in Indirect 


Explanation: An indirect command file included an iliegai 
element, as identified by the quoted part of the message. 


rh 
1) 
rh 
©) 
a) 
Q 
© 
rm 
a) 
a 
e) 
cr 
7) 
@ 
w 
a 
e 


User Action: Check indirect command fil 
yyy -- Sorry, low pool 


Explanation: The command could not execute because of 
insufficient space in the system pool (dynamic storage region). 


User Action: The pool is the Executive's data base. In general, 
each task, including commands, uses a certain amount of pool. If 
the pool is full or badly fragmented, there may not be sufficient 
space for the command to execute. Usually, pool problems clear 
up spontaneously if you wait. 


Retry the command after an interval. If it still does not 
execute, see your operator or system manager. You should not 
attempt to execute any other task, not even an ABORT or LOGOUT, 
when the pool is low. These tasks too absorb pool. 


= Pe eee 
aR AaACULVE 


Explanation: The command required some action that cannot be 
taken on an active task. 


User Action: Determine the cause of the error and correct it if 


you can. If you cannot, see your system manager or operator. 
Check the task with the various SHOW TASK commands, or SHOW 
MEMORY. 


yyy -- Sorry, task not installed 


Explanation: The command attempted to invoke a task that was not 
installed. 


User Action: Try running the task with a command in the RUN S&S 
form. Determine the cause of the error and correct it if you 
can. If you cannot, see your system manager or operator. 


yyy -- Syntax error 


Explanation: The command included some error in typing or 
specification, such as a letter where a number should appear. 


User Action: Check for proper syntax and reenter command. 
yyy -- Version must be explicit or "*" 


Explanation: The command syntax requires that the version number 
of the file must be specified explicitly or as a wildcard ( * ). 


User Action: Reenter the command with the version number 
correctly expressed. 


yyy -- Wildcards not permitted 


Explanation: Command included a wildcard (* or %) in a context 
where it is not permitted. 


User Action: Check for proper syntax and reenter command. 


A-15 


COMMON ERROR MESSAGES 


YYY -- Zero value not valid for key size or number 


Explanation: The command included a zero value in the 
definition argument to the /KEY qualifier. 


User Action: Check command for proper syntax and reenter. 


key 


APPENDIX B 


FUNCTIONS INITIATED BY DCL COMMANDS 


Most DCL commands initiate functions that are actually performed by 
MCR or by some other system task or utility. The following table 
gives these relationships, with any necessary comments. 


MCR Command, 


DCL Command Task, or Utility Comments 

ABORT ABORT 

ALLOCATE ALLocate 

APPEND PIP 

ASSIGN ASsigN Assign logical name 

ASSIGN/QUEUE QMG Assign queue to 
processor 

ASSIGN/REDIRECT REDirect Redirect device 

ASSIGN/TASK REAssign Alter LUN assignments 

BACKUP BRU 

BASIC BAS, BP2 

BROADCAST BROadcast 

CANCEL CANcel 

COBOL COB 

CONTINUE RESume 

CONVERT RMS CNV 

COPY PIP 

CORAL COR 

CREATE PIP, FCS 

CREATE/DIRECTORY UFD 

DEALLOCATE DEALlocate 

DEASSIGN ASsigN eassign logical name 


FUNCTIONS INITIATED BY DCL COMMANDS 


DCL Command 


DEASSIGN/QUEUE 


MCR Command, 
Task, or Utility Comments 


QMG 


Eliminate assignment of 
queue to processor 


DELETE 
DELETE/ENTRY 
DELETE/JOB 
DELETE/PROCESSOR 
DELETE/QUEUE 
DIFFERENCES 


DIRECTORY 


DISMOUNT 
EDIT 
FORTRAN 
FIX 


HELP 


HOLD/ENTRY 

HOLD/JOB 

INITIALIZE 
INITIALIZE/PROCESSOR 
INITIALIZE/QUEUE 


INITIALIZE/UPDATE 


INSTALL 
LIBRARY 


LINK 


CMP 


PIP 
RMS DSP 


DisMOunt 


EDT, EDI, 


FOR, F4P, F77 


FIX 


HEL1lo 


QMG 
QMG 
INItvolume 
QMG 
QMG 


Home 


INStall 
LBR 


TKB 


Delete files 


Delete despooler task 


Delete queue 


/ATTRIBUTES qualifier 


As part of HEL1o, HELP 
can run on unlogged-on 


me 


i tI 
CTLIUNLtliaAL De 


Create Volume 


Set up despooler task 


Alter volume's 
home block 


Task Builder. May be 
more than one on 

system. STK is Slow TKB. 
FTB is Fast TKB. 


DCL 


FUNCTIONS INITIATED BY DCL COMMANDS 


Command 


MOUNT 


PRINT 


PURGE 


RELEASE/ENTRY 


RELEASE/JOB 


REMOVE 


RENAME 


REQUEST 


RUN 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 


SHOW ACCOUNTING 0. 0 ACO 


[DAY] TIME 


DEFAULT 


DEVICE 
GROUPFLAGS 
LIBRARY/DIRECTORY 


PARTITION 


PRIORITY 
PROTECTION 
QUEUE 


SYSTEM/DIRECTORY 


SYSTEM/EXTENSION LIMIT 


SYSTEM/NOLOGINS 
SYSTEM/PACKETS 
SYSTEM/POOL 


TERMINAL 


SHOW ASSIGNMENTS 


SHOW CLOCK QUEUE 


SHOW COMMON 


SHOW [DAY] TIME 


SHOW DEFAULT 


MCR Command, 
Task, or Utility 
MOUnt 

QMG 

PIP 

QMG 

QMG 

REMove 

PIP 
BROadcast 
RUN INS 

TIMe 


SET /UIC 


DEVice 
FLAg 
SET /LIBUIC 


PAR, SET /MAIN, 
SET /PAR, SET SUB 


ALTer 

PIP 

QMG 

SET /SYSUIC 

SET /MAXEXT 

SET /NOLOGON 
SET /MAXPKT 

SET /POOL 


SET /attribute 


TIM 


SET /UIC 
ASsigN 


B-3 


Comments 


SET for UFD 
ASN for SY: 


Resource Accounting 


Common Block Directory 


SET for UFD 
ASN for SY: 


FUNCTIONS 


DCL Command 
SHOW DEVICES 
SHOW GROUPFLAGS 


ne a 
SHOWw?t 
: VW 

pe is rae 


SHOW MEMORY 


SHOW PARTITIONS 

SHOW PROCESSOR 

SHOW QUEUE 

SHOW SYSTEM/CLI 

SHOW SYSTEM/DIRECTORY 

SHOW SYSTEM/EXTENSION LIMIT 
SHOW SYSTEM/PCOOL 

SHOW SYSTEM/SECONDARY_ POOL 
SHOW TASKS/ACTIVE 

SHOW TASK:taskname/ACTIVE 
SHOW TASKS/DYNAMIC 

SHOW TASKS/INSTALLED 

SHOW TASKS/INSTALLED/FULL 
SHOW TASK:taskname/INSTALLED 
SHOW TERMINAL 


SHOW TERMINAL/attribute 


SHOW USERS 


START 
START/PROCESSOR 
START/QUEUE 
START/QUEUE/MANAGER 
START/UNBLOCK 
STOP/ABORT 


STOP/BLOCK 


INITIATED BY DCL COMMANDS 


MCR Command, 


Task, or Utility Comments 

DEV 

SET /PUB /PUBLIC qualifier 
SET /BUF /WIDTH qualifier 


RMD Resource Monitoring 
Display 

PAR 

QMG 

QMG 

CLI /SHOW 


SET /SYSUIC 


SET /MAXEXT 


SET /SECPOL 


SET /attribute 


SRT SORT-11 


QMG 
UNBLocK 
QMG 


Block 


FUNCTIONS INITIATED BY DCL COMMANDS 


MCR Command, 


DCL Command Task, or Utility Comments 
STOP/PROCESSOR OMG 
STOP/QUEUE QMG 
STOP/QUEUE/MANAGER QMG 


TYPE PIP 
UNFIX UNFix 
UNLOCK PIP 


APPENDIX C 


SUMMARY OF TECHNICAL CHANGES 


This appendix lists all changes in DCL syntax from RSX-11M-PLUS v1.0 
to RSX-11M-PLUS v2.0, and from RSX-11M/M-PLUS V4.0/2.0 to 
RSX-11M/M-PLUS V4.1/2.1. Section C.1 lists all commands and 
qualifiers that have changed syntax since V1.0, Section C.2 lists all 
syntax elements that have been added to DCL since V1.0, and Section 
C.3 lists all commands and syntax elements that have been added or 
changed for vV4.1/2.1. 


C.1 CHANGED SYNTAX 


This section lists all commands and qualifiers changed since V1.0 of 
RSX-1L1M-PLUS. 


Old New 
ABORT ABORT 
/ (NO] DUMP /{NOj] POSTMORTEM 
APPEND APPEND 
/ INDEXED [/KEY:NUMBER:n] No support (use CONVERT) 
/RELATIVE No support (use CONVERT) 
/SEQUENTIAL No support (use CONVERT) 
ARCHIVE BACKUP 
/BACKUP SET:name /SAVE SET:name 
/BAD:arg /BADBLOCKS :arg 
/BUFFERS:n /ACCESSED:n 
/CREATED:arg /CREATED 
/CREATED: AFTER: time /CREATED/AFTER: time 
/CREATED: BEFORE:time /CREATED/BEFORE: time 
/DIRECTORY /LIST 
/DISPLAY /LOG 
/ERRORS:n /ERROR LIMIT:n 
/EXTEND:n /EXTENSION:n 
/INVOLUME:volumelabel /LABEL: INPUT: volumelabel 
/MAXIMUM:n /MAXIMUM FILES:n 
/OUTVOLUME:volumelabel /LABEL: [OUTPUT: ] volumelabel 
/POSITION:arg /INDEX:arg 
/POSITION: BLOCK:n /INDEX:n 
/PROTECTION:code /FILE PROTECTION: code 
/REVISED:arg /MODIFIED 
/REVISED: AFTER: time /MODIFIED/AFTER: time 
/REVISED: BEFORE: time /MODIFIED/BEFORE: time 
/ [NO] SUPERSEDE / [NO] REPLACE 
/TAPE LABEL: volumelabel /LABEL: TAPE: volumelabel 


SUMMARY OF TECHNICAL CHANGES 


Old 


COBOL 

/SWITCHES :arg 
/SWITCHES: ([-]CVF) 
/SWITCHES: ([-]BOU) 
/ SWITCHES: ([-]CM6) 
/SWITCHES: ( [=] CREF) 
/SWITCHES: (SYM:n) 
/SWITCHES: (KER: xx) 
/SWITCHES: (PFM:n) 
/ SWITCHES: ([-] OV) 
/SWITCHES: ([-] PLT) 
/SWITCHES: ([-] RO) 


/SWITCHES: ([-] NL) 
/SWITCHES: ([-] MAP) 
/SWITCHES: ([-]OBJ) 
/SWITCHES: (ERR:1) 
/ SWITCHES: (ERR? 2) 


COPY 
/ INDEXED [/KEY:NUMBER:n] 
/RELATIVE 
/SEQUENTIAL 


CREATE 
/FORMAT :arg 
/ INDEXED 
/KEY:arg 
/RELATIVE 
/SEQUENTIAL 


CREATE/DIRECTORY 


/VOLUME_NAME: label 
DELETE 

/DIRECTORY_ENTRY 

/LIST | 

/SELECTIVE 


DELETE/QUEUE queuename jobname 
DELETE/QUEUE queuename jobname 


DIFFERENCE 
/ 


/BLANK LINES 


/NOCOMMENTS 
/FORM_FEED 


/IGNORE_SPACING 
/NOTRAILING BLANKS 
/VERTICAL BAR:n 
/CHANGE BAR 


DIRECTORY 
/PRINT 


DISMOUNT 
/DEVICE 
/USER 


COBOL 


COPY 


New 


No support 
/(NO]ANSI FORMAT 
/ [NO] CHECK 
/ [NO]CM6 
/ (NO]CROSS_REFERENCE 
/LARGE_SYMBOL_TABLE:n 
/NAMES : xx ae 
/NESTin 
/ {(NO] OVERLAY 
/{NO]POOL LITERALS 
/ [NO] READONLY 
/ [NO] SHOW: (arg[s]) 
COPY LIST 
MAP 
VERB LOCATION 
/WARNINGS - 
/NOWARNINGS 


No support 
No support 
No support 


(use CONVERT) 
(use CONVERT) 
(use CONVERT) 


No support 
No support 
No support 
No support 
NO support 


(use CONVERT) 
(use CONVERT) 
(use CONVERT) 
(use CONVERT) 
(use CONVERT) 


CREATE/DIRECTORY 


DELETE 


/LABEL? Label 


No support (use PIP) 
{LOG 
/QUERY 


DELETE/JOB queuename jobname 
DELETE/ENTRY:n 


DIFFERENCES 


Default; to override, specify 
/IGNORE:BLANK LINES 

/ IGNORE: COMMENTS | 

Default; to override, specify 
/IGNORE:FORM FEEDS 

/ IGNORE: SPACING | 

/ IGNORE: TRAILING BLANKS 

/CHANGE BAR:n 

/CHANGE BAR:n 


DIRECTORY 


/PRINTER 


DISMOUNT 


/PUBLIC 
/ALL 


SUMMARY OF TECHNICAL CHANGES 


Old 


FIX 
/ READONLY 


FORTRAN 
/ SWITCHES: (/CK) 
/SWITCHES: (/CO:n) 
/SWITCHES: (/DE) 
/ SWITCHES: (/EX) 
/SWITCHES: (/ID) 
/SWITCHES: (/14) 
/SWITCHES: (/LA) 
/ SWITCHES: (/LI:n) 


/SWITCHES: (/NOTR) 
/SWITCHES: (/OP) 
/SWITCHES : (/RO) 
/SWITCHES: (/SN) 
/SWITCHES: (/TR: ALL) 
/SWITCHES: (/TR:BLOCKS) 
/SWITCHES: (/TR: LINES) 
/SWITCHES: (/TR: NAMES) 
/ SWITCHES: (/TR: NONE) 
/SWITCHES: (/VA) 

/ SWITCHES: (/WR) 


HELP 
/UNS 


HOLD/QUEUE 
/ENTRY: (m,n) 
HOLD/QUEUE qname jobname 


INITIALIZE (Initalize volume) 
/DENSITY:HIGH 
/DENSITY: LOW 
/INDEX:BLOCK:n 
/MAXIMUM:in 
/PROTECTION: code 
/VERIFIED 
/NOVERIFIED 
/WINDOW:n 


INITIALIZE (Initialize QMG function) 
/APPLICATIONS PROCESSOR 
/BATCH_ PROCESSOR 
/DEVICE 
/PRINTER 
/ PROCESSOR 


INSTALL 
/ (NO] DUMP 
/TASK:name 


LIBRARIAN CREATE 

/EPT:n 

/MNT:n 

/SIZEtin 

/ (NO] ENTRYPOINTS 
/TYPE:MACRO 
/TYPE:OBJECT 
/SELECT SYMBOLS 


FIX 


FORTRAN 


HELP 


HOLD 


New 


/ READONLY SEGMENT 


/ [NO] CHECK 
/CONTINUATIONS:n 
/ [NO] DLINES 

/ [NO] EXTEND 

/ IDENTIFICATION 
/(NO]I4 

No support 
/MACHINE CODE 
/MAP 


/ TRACEBACK: NONE 
No support 

/ SHAREABLE 
/{NO]LINE_NUMBERS 
/ TRACEBACK: ALL 

/ TRACEBACK : BLOCKS 
/ TRACEBACK: LINES 
/ TRACEBACK : NAMES 
/TRACEBACK:NONE 

/ [NO] VECTORS 

/ [NO] WARNINGS 


No support 


/ENTRYin 
/JOB qname[:] jobname 


INITIALIZE 


No support 

No support 

/INDEX:n 
/MAXIMUM_FILES:n 
/FILE PROTECTION: code 
/BADBLOCKS : AUTOMATIC 
/BADBLOCKS : MANUAL 
/WINDOWS :n 


INITIALIZE 


INSTALL 


/PROCESSOR: APPLICATIONS PROCESSOR 
/ PROCESSOR: BATCH PROCESSOR 
/PROCESSOR:DEVICE 

/ PROCESSOR: PRINTER 

No support 


/ [NO] POSTMORTEM 
/TASK_NAME:name 


LIBRARY/CREATE 

LIBRARY/CREATE: (GLOBALS:n) 
LIBRARY/CREATE: (MODULES: n) 
LIBRARY/CREATE: (BLOCKS:n) 


/ [NO]GLOBALS 
/MACRO 

/OBJECT 
/SELECTIVE SEARCH 


SUMMARY OF TECHNICAL CHANGES 


Old 


LIBRARIAN DELETE/MODULES 


LIBRARIAN DELETE/GLOBAL SYMBOLS 


LIBRARIAN EXTRACT 
/OUTPUT: filespec 


LIBRARIAN INSERT 
/ [NO] ENTRYPOINTS 
/SELECT_SYMBOLS 


LIBRARIAN LIST 
/OUTPUT: filespec 
/ENTRIES 


LIBRARIAN REPLACE 
/ [NO] ENTRYPOINTS 
/SELECT_SYMBOLS 


LIBRARIAN SQUEEZE 
/EPT:n 
/MNT:n 
/SIZE:n 


LINK 
/COMPATIBILITY MODE 
/ [NO] CONCATENATED 
/DUMP 
/EXTENDED ARITHMETIC 
/ELOATING POINT 
/GLOBAL_SYMBOLS 
/LIBRARY modl...modN 
/MULTIUSER 
/OVERLAY: filespec 
/POSITION_INDEPENDENT 


/SELECT_SYMBOLS 
/STOP:n 
/SYMRBOLS:filesnec 
/WIDE_MAP 


MACRO 

/SWITCHES:arg 
/SWITCHES: (/DS:arg) 
/SWITCHES: (/DS:AMA) 
/SWITCHES: (/DS: ABS) 
/SWITCHES: (/DS:CDR) 
/SWITCHES: (/DS:GBL) 
/SWITCHES: (/DS:LSB) 
/SWITCHES: (/DS:LC) 
/SWITCHES: (/DS: REG) 
/SWITCHES: (/DS:FPT) 
/SWITCHES: (/EN:arg) 
/ SWITCHES: (/EN: AMA) 
/SWITCHES: (/EN:ABS) 
/SWITCHES: (/EN:CDR) 
/SWITCHES: (/EN:GBL) 
/ SWITCHES: (/EN:LSB) 
/SWITCHES: (/EN:LC) 
/SWITCHES: (/EN: REG) 
/SWITCHES: (/EN:FPT) 


New 


LIBRARY/DELETE libspec module[s] 
LIBRARY/REMOVE libspec global[s] 


LIBRARY/EXTRACT libspec module[s] 


/OUTPUT [:filespec] 
LIBRARY/INSERT 

/ {NO] GLOBALS 

/SELECTIVE SEARCH 


LIBRARY/LIST[{:filespec] 


No support (use /LIST:filespec) 


/ NAMES 


LIBRARY /REPLACE 
/ [NO] GLOBALS 
/SELECTIVE SEARCH 


LIBRARY/COMPRESS 
LIBRARY/COMPRESS: (GLOBALS:n) 
LIBRARY/COMPRESS : (MODULES :n) 
LIBRARY /COMPRESS: (BLOCKS :n) 


LINK 
/COMPATIBLE 
/ [NO] CONCATENATE 
/POSTMORTEM 
/CODE: EAE 
/CODE:FIS 
/GLOBALS 


/ INCLUDE: (mod1l,...,modN) 


/SHAREABLE 
/OVERLAY DESCRIPTION 


/CODE: POSITION INDEPENDENT 


or /CODE:PIC 
/SELECTIVE SEARCH 
/ERROR_LIMIT:n 


/GUMDNAT MART Ps fi las 
‘(=u *@eseavbsiass ae Ne 


aie 


MACRO 

No support 

/DISABLE: (arg{s]) 
ABSOLUTE 
BINARY 
CARD FORMAT 
GLOBAL 
LOCAL 


REGISTER DEFINITI 


TRUNCATION 
7 ENABLE: (arg[s]) 

ABSOLUTE 

BINARY 

CARD FORMAT 

GLOBAL 

LOCAL 

LOWER CASE 


REGISTER_DEFINITIONS 


TRUNCATION 


SUMMARY OF TECHNICAL CHANGES 


Old 


/SWITCHES: (/LI:arg) 
/SWITCHES: (/LI:BEX) 
/SWITCHES: (/LI:BIN) 
/SWITCHES: (/LI:CND) 
/SWITCHES: (/L1I:COM) 
/SWITCHES: (/LI:LD) 

/SWITCHES: (/LI:LOC) 
/SWITCHES: (/LI:MC) 

/SWITCHES: (/LI:MD) 

/SWITCHES: (/LI:ME) 

/SWITCHES: (/L1I:MEB) 
/SWITCHES: (/LI:SEQ) 
/SWITCHES: (/LI:SRC) 
/SWITCHES: {(/L1:SYM) 
/SWITCHES: (/LI:TOC) 
/SWITCHES: (/NL:arg) 
/SWITCHES: (/NL: BEX) 
/SWITCHES: (/NL:BIN) 
/SWITCHES: (/NL:CND) 
/SWITCHES: (/NL:COM) 
/SWITCHES: (/NL:LD) 

/SWITCHES: (/NL:LOC) 
/SWITCHES: (/NL:MC) 

/ SWITCHES: (/NL:MD) 

/SWITCHES: (/NL:ME) 

/ SWITCHES: (/NL:MEB) 
/SWITCHES: (/NL:SEQ) 
/SWITCHES: (/NL:SRC) 
/SWITCHES: (/NL:SYM) 
/SWITCHES: (/NL: TOC) 
/SWITCHES: (/NL: TTM) 
/SWITCHES: (/LI:TTM) 


MESSAGE/TERMINAL:dev: 
MESSAGE @filespec 
/LOGGED_ON 


MOUNT 
/ACPiname 


/FILE CONTROL BLOCKS:n 


/PROTECTION: code 
/UNLOCKED_INDEX 
/WINDOW:n 


PRINT 
/JOB: jobname 
/ORIGINAL 
/NOORIGINAL 
/PAGES:n 


PURGE 
/LIST 


RELEASE/QUEUE 
/ENTRY: (m,n) 
RELEASE/QUEUE qname jobname 


RUN 
/DRIVER 


/ {NO] DUMP 
/7TASK:name 


SET DEFAULTS [dev:] [uic] 


New 


/SHOW: (arg[s]) 
EXTENSIONS 
OBJECT. BINARY 
CONDITIONALS 
COMMENTS 
LISTING DIRECTIVES 
COUNTER 
CALLS 
DEFINITIONS 
EXPANSIONS 
BINARY 
SEQUENCE NUMBERS 
SOURCE 
SYMBOLS 
CONTENTS 

/NOSHOW: (arg[s]) 
EXTENSIONS 
OBJECT BINARY 
CONDITIONALS 
COMMENTS 
LISTING DIRECTIVES 
COUNTER — 
CALLS 
DEFINITIONS 
EXPANSIONS 
BINARY 
SEQUENCE NUMBERS 
SOURCE 
SYMBOLS 
CONTENTS 

/WIDE 

/NOWIDE 


BROADCAST dev: 
BROADCAST @filespec 


MOUNT 


PRINT 


PURGE 


RELEASE 


RUN 


/LOGGED_IN 


/ PROCESSOR: name 
/ACCESSED:n 

/FILE PROTECTION:code 
/UNLOCK 

/WINDOWS :n 


/NAME: jobname 
/NOTRANSFER 
/ TRANSFER 
/PAGE COUNT:n 


/LOG 


/ENTRYin 
/JOB qname jobname 


No support (use MCR LOAD) 
/ [NO] POSTMORTEM 
/TASK_NAME:name 


SET DEFAULT: [dev:] [uic] 


SET 


SET 
SET 


SET 


SET 


SET 


SET 


SET 


SET 


SET 
SET 


SET 


SET 


SUMMARY OF TECHNICAL CHANGES 


Old 


DEVICE:dev: option[s] 
[NO]CHECKPOINT FILE[:n] 
[NO] LOWER 
[NO] PUBLIC 
WIDTH:n 
[NO]WRITECHECK 


GROUPFLAGS CREATE [n] 
GROUPFLAGS DELETE [n] 


LIBRARY UFD:ufd 
[NO] LOGINS 


PARTITIONS options 
NAME: name 
BASE:n 
SIZE:n 
TYPE:DEVICE 
TYPE:DIAGNOSTIC 
TYPE: SYSTEM 

NOPARTITION name 


PRIORITY name number 
PROTECTION filespec[s] code 


QUEUE ENTRY: (m,n) option(s] 
QUEUE queuename jobname 


ATamt eS 
AFTER: time 


FORMS:n 

HOLD 

LENGTH:n 

[NO] LOWERCASE 
PAGES:n 
PRIORITY:n 
RELEASE 


[NO] UPPERCASE 
SYSTEM_UFD ufd 


TERMINAL[:TTnn:] option 
ASR33 
ASR35 
DCL 
[NO] ECHO 
[NO] EIGHT BIT 
{NOj ESCAPE 
[NO] FORM_ FEED 
[NO] FULL DUPLEX 
[NO] HARDCOPY 
HFILL:n 
[NO] HOLD SCREEN 
[NO] INTERACTIVE 
KSR33 
LA30P 
LA30S 
LA36 
LA120 
LA180S 
{NO] LOCAL 
[NO] LOWERCASE 


SET 


SET 
SET 


SET 


SET 


SET 


SET 
SET 
SET 


SET 
SET 


SET 


SET 


New 


DEVICE:dev:/qualifier[s] 
/{NO}]CHECKPOINT FILE[:n] 
/ [NO] LOWERCASE 
/ {NO] PUBLIC 
/WIDTH:n 
/ [NOJWRITECHECK 


GROUPFLAGS :n/CREATE 
GROUPFLAGS :n/DELETE 


LIBRARY/DIRECTORY :ufd 
SYSTEM/ [NO] LOGINS 


PARTITION: name/qualifiers 


"name" is argument to PARTITION 


/BASE:n 
/SIZEin 
/DEVICE 
/DIAGNOSTIC 
/ SYSTEM 
NOPARTITION: name 


PRIORITY:n name 
PROTECTION filespec[s] (code) 


QUEUE/ENTRY:n/qualifier[s] 
QUEUE/JOB queuename jobname 
/AFTER: time 
/FORMS:n 
/HOLD 
/LENGTH:n 
/ [NO] LOWERCASE 
/PAGE COUNT:n 
/PRIORITY:n 
/ RELEASE 
/ (NOj RESTART 
/ {NO] UPPERCASE 


SYSTEM/DIRECTORY :ufd 


TERMINAL[:TTnn:]/qualifier{[s] 
/ASR33 
/ASR35 
/DCL 
/ [NO] ECHO 
/{NO]EIGHT_BIT 
/ [NO] ESCAPE 
/ [NO] FORM_FEED 
/(NO] FULL DUPLEX 
/ {(NO] HARDCOPY 
/CRFILL:in (synonym) 
/{NO]HOLD_SCREEN 
/ (NO] INTERACTIVE 
/KSR33 
/LA30P 
/LA30S 
/LA36 
/LA1L20 
/LA180S 
/ [NO] LOCAL 
/ [NO] LOWERCASE 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 
SHOW 


SHOW 
SHOW 
SHOW 


SUMMARY OF TECHNICAL CHANGES 


Old 


MCR 

PAGE:n 

[NO] PASSALL 
[NO] REMOTE 
(NO]SCOPE 
SPEED:arg 
[NO] TAB 

[NO] TYPE AHEAD 
UNKNOWN:n 
(NO] UPPERCASE 
VFILLin 

VTO5 

VT52 

VT55 

VT61l 

VT100 
{NO]WRAP 


ACCOUNTING INFORMATION 


ASSIGNMENTS :arg 
: GLOBAL 


: LOCAL 
:LOGIN 
: TERMINAL:dev: 


BUFFER POOL 


COMMON BLOCK DIRECTORY name opt 
TASKS 


DEFAULTS 


DEVICES option 
{NOC] PUBLIC 
TYPE dd: 
WIDTH:ddnn: 
(NO]JWRITECHECK 


LIBRARY _UFD 
LOGICAL UNITS 
PARTITIONS name 


PROCESSOR ALL 
PROCESSOR name 


QUEUE ALL option(s] 
QUEUE queuename option{[s] 
QUEUE ENTRY: (m,n) option{[s] 


FORMS 

NAME :name 
NUMBER 
PRINT 
PRIORITY:n 
USER: [g,m] 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 


SHOW 
SHOW 


SHOW 
SHOW 
SHOW 


New 


/MCR 
/PAGE_LENGTH:n 

/ [NO] PASSALL 

/ {NO] REMOTE 

/ [NO] SCOPE 

/ SPEED: (arg) 

/ (NO) TAB 

/ (NO) TYPE AHEAD [:n] 
/MODEL:n 

/ [NO] UPPERCASE 
/LEFILL:n (synonym) 
/VT05 

/VT52 

/VT55 

/VT61 

/VT100 

/ {NOJWRAP 


ACCOUNTING/ INFORMATION 


ASSIGNMENTS/qualifier 
/GLOBAL 
/SYSTEM 
/LOCAL 
/LOGIN 
/ TERMINAL :dev: 


(synonym added) 


SYSTEM/POOL 


COMMON [:name] /qualifier 
/ TASK 


DEFAULT 


DEVICES [:dd[:]]/qualifier 
/ {NO] PUBLIC 
"dd:" is argument to DEVICES 
/WIDTH 
No support 


LIBRARY/DIRECTORY 
TASKS [:name] /LOGICAL UNITS 
PARTITIONS :name 


PROCESSOR 
PROCESSOR name[:] 


QUEUE/qualifier[s] 
QUEUE queuename/qualifier([s] 
QUEUE/ENTRY:n/qualifier[s] 
/ALL 
/BATCH 
/BRIEF 
/FULL 
/ FORMS 
/NAME: name 
/NUMBER 
/ PRINTER 
/PRIORITY:n 
/OWNER_UIC: [g,m] 


SUMMARY OF TECHNICAL CHANGES 


[NO] FORM FEED 
[NO] FULL_DUPLEX 
[NO] HARDCOPY 
HFILL 
[NO]HOLD_ SCREEN 
[NO] INTERACTIVE 
[NO] KSR33 

[NO] LA30P 
[NO]LA30S 

[NO] LA36 
[NO]LA120 
[NO]LA180S 
[NO] LOCAL 

[NO] LOWERCASE 
MCR 

MODEL 

PAGE 

[NO] PASSALL 
[NO] PRIVILEGE 
[NO] REMOTE 
[NO] SCOPE 

[NO] SLAVE 
SPEED 

[NO] TAB 

[NO] TYPE AHEAD 
[NO] UPPERCASE 
VFILL 

[NO] VTO5 

[NO] VT52 

[NO] VT55 

[NO] VT61 

[NO] VT100 
[NO]WRAP 


SORT/OUTPUT: file inputfile 


/FILES:n 


/EORMAT: (format :size) 


/KEYS:arg 


START/processortype 
/APPLICATIONS PROCESSOR 


/BATCH_ PROCESSOR 
/DEVICE 

/PRINTER 

/ PROCESSOR 
/AT_PAGE:n 
/NEXT_JOB 


Old New 
SHOW SYSTEM UFD SHOW SYSTEM/DIRECTORY 
SHOW TASKS option SHOW TASKS [:name] 
ACTIVE [TERMINAL:TTnn:] /ACTIVE[:TTnn[:]] 
ALL /ALL 
BRIEF /BRIEF 
FULL / FULL 
INSTALLED / INSTALLED 
SHOW TERMINAL[:TTnn:] option SHOW TERMINAL[:TTnn:] [/qualifier] 
[(NO]ASR33 /ASR33 
[NO] ASR35 /ASR35 
DCL /DCL 
[NO] ECHO 7 {NO] ECHO 
(NO] EIGHT BIT /(NOJEIGHT BIT 
{NO] ESCAPE / [NO] ESCAPE 


/{NO]FORM FEED 
/({NO]FULL_ DUPLEX 
/ [NO] HARDCOPY 
/CRFILL:n (synonym) 
/{NO]HOLD_SCREEN 
/ [NO] INTERACTIVE 
/KSR33 

/LA30P 

/LA30S 

/LA36 

/LA120 

/LA180S 

/ [NO] LOCAL 

/ [NO] LOWERCASE 
/MCR 

/MODEL 

/PAGE LENGTH 

/ [NO] PASSALL 

/ [NO] PRIVILEGE 

/ [NO] REMOTE 
/{NO1SCOPE 

/ [NO] SLAVE 
/SPEED 

/ [NO] TAB 
/{NO]TYPE AHEAD 
/ [NO] UPPERCASE 
/LFFILL (synonym) 
/VT05 

/VT52 

/VT55 

/VT61 

/VT100 

/ [NOJWRAP 


SORT inputfile outputfile 


/WORK FILES:n 
/FORMAT: (format,size) 
/KEY:arg 


START/PROCESSOR: type 
APPLICATIONS PROCESSOR 


BATCH PROCESSOR 
DEVICE 

PRINTER 

No support 
/PAGE:n 

/NEXT 


SUMMARY OF TECHNICAL CHANGES 


Old 
STOP 
STOP/DRIVER 
STOP/processortype 
/APPLICATIONS PROCESSOR 
/BATCH_ PROCESSOR 
/DEVICE 
/PRINTER 
/PROCESSOR 
SUBMIT 
/PRINT 
/NOORIGINAL 
/ORIGINAL 
UNFIX 
/ READONLY 
C.2 NEW SYNTAX 
This section lists all syn 
Many qualifiers have al 
listed. Most /NO forms ar 


ALLOCATE/TYPE:devtype 


APPEND 
/DATE:dd-mmm-yy 
/SINCE :dd-mmm-yy 
/THROUGH :dd-mmn-yy 


ia 


t 11M- 
so added the /NO 
e defaults. 


New 


No support 


No support {use MCR UNLOAD) 
STOP/PROCESSOR: type 
APPLICATIONS PROCESSOR 
BATCH PROCESSOR 
DEVICE 
PRINTER 
No support 


SUBMIT 
/PRINTER 
/ TRANSFER 
/NOTRANSFER 


UNFIX 
, / READONLY SEGMENT 


/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 


/ TODAY 
/EXCLUDE:filespec 


ASSIGN 
/SYSTEM 


BACKUP 
/DENSITY:6250 
/NOLOG 
/ PRESERVE 


BROADCAST username 
/ALL 
/LOGGED_IN 


(synonym for /GLOBAL added), 


SUMMARY OF TECHNICAL CHANGES 


CONVERT (new command) 
/ [NOJAPPPEND 
/BLOCK_SIZE:n 
/({NO] FIXED CONTROL 
/ [NO] IDENTIFICATION 
/ INDEXED 
/KEY[:n] 
/{NO]LOG FILE[:filespec] 
/{NO]MASS_INSERT 
/ MERGE 
/{NO]PAD[: [(#] x] 
/RELATIVE 
/ [NO] REPLACE 
/SEQUENTIAL 
/(NO] TRUNCATE 


COPY 
/DATE:dd-mmm-yy 
/SINCE:dd-mmm-yy 
/ THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 
/ TODAY 
/EXCLUDE:filespec 


DEASSIGN 
/ SYSTEM (synonym for /GLOBAL added) 
DEBUG (new command) 


DELETE 
/DATE:dd-mmm-yy 
/SINCE:dd-mmm-yy 
/THROUGH: dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 
/TODAY 
/EXCLUDE: filespec 


DELETE/JOB 
/FILE POSITION:n 


DELETE/ENTRY:n 
/FILE POSITION:n 
DIRECTORY 
/DATE:dd-mmm-yy 
/SINCE :dd-mmm-yy 
/ THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 
/ TODAY 
/EXCLUDE: filespec 


EDIT/EDT 
/ [NO]COMMAND [:filespec] 
/ [NO] JOURNAL [:filespec] 
/({NO]OUTPUT[:filespec] 
/ (NO]READ_ONLY 
/ [NO] RECOVER 


EDIT/KED 
EDIT/K52 
/CREATE 
/OUTPIT[: filespec] 


SUMMARY OF TECHNICAL CHANGES 


EDIT/SLP 

/{NOJAUDIT TRAIL[: (arg[s]) ] 
POSITION:n 
SIZEsn 

/ [NO] CHECKSUM[:n] 

/(NO]LIST([:filespec] 

/{NO] OUTPUT [:filespec] 

/ {NO] REPORT 

/ ({NO] TAB 

/{NO] TRUNCATE [:n] 


FORTRAN/FOR 
/CODE:arg 
EAE 
EIS 
FIS 
THREADED 
FORTRAN/F77 
FORTRAN/NOF77 
HELP 


/CLI:cliname 
/FILE: filespec 
/GROUP 

/LOCAL 

/OUTPUT: filespec 


INITIALIZE (Initialize volume) 
/BADBLOCKS: OVERRIDE 
/DENSITY: 6250 


INITIALIZE (Initialize QMG function) 
/PROCESSOR:CARD READER 
/ PROCESSOR: INPUT 
/BATCH QUEUE:name 
/CONSOLE:dev: 
/PRINTER QUEUE:name 
/SHAREABLE 
/NOSHAREABLE 
/NOUPPERCASE 
/NOLOWERCASE 


INITIALIZE/UPDATE (new command) 
/ACCESSED:n 
/DENSITY:arg 

800 

1600 

6250 
/EXTENSION:n 
/FILE PROTECTION: code 
/OWNER: [g,m] 
/MAXIMUM FILES:n 
/PROTECTION: code 
/ SHOW 
/LABEL 
/WINDOWS:n 


SUMMARY OF TECHNICAL CHANGES 


INSTALL 
/COMMAND: "taskcommand" 


LIBRARY/CREATE 
/UNIVERSAL 


LINK 
/EXECUTABLE:filespec (synonym for /TASK added) 
/SAVE 


LOGOUT 
/ [NO] HOLD 


MOUNT 
/BLOCK SIZE:n 
/CARRIAGE CONTROL: arg 
FORTRAN 
LIST 
NONE 
/DEFAULT:arg 
{NO] UNLOAD 
SAVE 
/DENSITY: 6250 
/ ({NOJ]HDR3 
/ {NO] LABEL 


/OVERRIDE: arg 


WV SINAN Div lie Ke 


ACCESSIBILITY 
SET IDENTIFICATION 
/OWNER_UIC: [uic] 
/{NO] PUBLIC 
/RECORD SIZE:n 
/ [NO] SHAREABLE 
/LNG}SYSTEM 
/TRANSLATE?z arg 
EBCDIC 
NONE 
UT1 
UT2 
UT3 
/VOLUME IDENTIFICATION: name[s] 
/{NO]WAIT 


/WINDOWS :n 
/ {[NO]WRITE 


PRINT 
/JOB COUNT:n 
/(NO]JOB_PAGE 
/NOLOWERCASE 
/NOUPPERCASE 


PURGE 
/NOLOG 
/DATE:dd-mmm-yy 
/SINCE:dd-mmm-yy 
/ THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH:dd-mmm-yy 
/ TODAY 


m n ee 
/EXCLUDE: filespec 


SUMMARY OF TECHNICAL CHANGES 


REQUEST (new command) 


RUN 
/COMMAND:"taskcommand" 


SET PARTITION: name 


/ COMMON (RSX-11M only) 
/SUBPARTITION (RSX-11M only) 
/TASK (RSX-11M only) 


SET PROTECTION 
/DATE:dd-mmm-yy 
/SINCE :dd-mmm-yy 
/THROUGH :dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 
/ TODAY 
/EXCLUDE:filespec 


SET QUEUE/ENTRY:n 

SET QUEUE/JOB queuename jobname 
/COPIES:n 
/ [NO] DELETE 
/FILE POSITION:n 


SET SYSTEM 
/PACKETS:n 
/POOL:top:max:total 


SET TERMINAL[:TTnn: ] 
/WIDTH:n 
/ [NO] BROADCAST 


SHOW ACCOUNTING . 
/TRANSACTIONS [:infile] outfile 


SHOW PROCESSOR 
/BATCH 
/CARD_READER 
/DEVICE 
/ INPUT 
/PRINT 


SHOW QUEUE 
/DEVICE 
/FILES 


SHOW SYSTEM 
/CLI 
/EXTENSION LIMIT 
/SECONDARY_ POOL 


SHOW TASKS 
/DYANAMIC 


SHOW TASK: taskname/DYNAMIC 
/RATE:n 


SUMMARY OF TECHNICAL CHANGES 


SHOW TASKS/ACTIVE/DYNAMIC 
/OWNER:ddnn: 
ALL 
/PRIORITY:n 
/RATE:n 


SORT 
/NOCONTIGUOUS 
/SPECIFICATION:filespec 


START/PROCESSOR: type 
CARD READER 
INPUT 


START/UNBLOCK (new command) 


STOP 
/ABORT printername: 
/PROCESSOR:arg 
CARD_READER 
INPUT 


STOP/BLOCK (new command) 


SUBMIT 
/{NO]LOG FILE 


TYPE 
/DATE:dd-mmm-yy 
/SINCE:dd-mmm-yy 
/ THROUGH: dd-mmm-yy 
/SINCE:dd-mmm-yy/THROUGH :dd-mmm-yy 
/TODAY 
/EXCLUDE: filespec 


UNLOCK 
/DATE:dd-mmm-yy 
/SINCE :dd-mmm-yy 
/ THROUGH :dd-mmm-yy 
/SINCE :dd-mmm—-yy/THROUGH :dd-mmm-yy 
/TODAY 
/EXCLUDE:filespec 


C.3 NEW OR CHANGED COMMANDS AND SYNTAX FOR V4.1/2.1 


This section lists all syntax added to or changed in RSX-11M/M-PLUS 
DCL since V4.0/2.0. 


BACKUP /DIRECTORY 
/IMAGE:arg 
SAVE 

RESTORE 


BASIC BASIC-PLUS-2 is now the default compiler. 


SUMMARY OF TECHNICAL CHANGES 


COBOL COBOL-81 is now the default compiler. 
Qualifiers added for COBOL-81: 


/{[NO]JANSI FORMAT 
/{NO]CHECK:arg 
[NO] BOUNDS 
[NO] PERFORM 
ALL 
NONE 
/CODE: [NO]JCIS 
/[NO]CROSS REFERENCE 
/{NO]DEBUG 
/ [NO] DIAGNOSTICS [: filespec] 
/{(NO]LIST(:filespec] 
/ NAMES 2 XxX 
/{NO]OBJECT [:filespec] 
/ [NO]OVERLAY DESCRIPTION 
/ {NO]SHOW: [NO] MAP 
/ [NO] SKELETON 
/ [NO] SUBPROGRAM 
/ TEMPORARY :device 
/ [NO] TRUNCATE 
/ [NO]WARNINGS: [NO] INFORMATIONAL 


For the PDP-11 COBOL compiler, the /[NO]ODL 
qualifier has been deleted while the /[NO]SKL, 
/C1ll, /[NO]SUBPROGRAM, and /TEMPORARY:dev 
qualifiers have been added. 


CORAL New command and qualifiers to invoke the CORAL 66 compiler. 


Qualifiers are: 


/ [NO] CHECK 
/CODE:arg 
EIS 
FIS 
FPP 
PIC 
(EIS, PIC) 
(FIS, PIC) 
(FPP, PIC) 
/{NO]EXTEND SOURCE 
/ (NOJLIST[:filespec] 
/ (NO]MACHINE CODE 
/NAMES:x 
/ (NO]OBJECT[:filespec] 
/ [NOJOPTIMIZE[:LEVEL:n] 
/READ_ ONLY [:arg] 
ALL 
NONE 
PURE DATA 
/(NO]SHOW[:arg[,Ss])] 
ALL 
[NO] EXPANSIONS 
NONE 
[NO] OVERRIDE 
[NO] SOURCE 
[NO]STATISTICS 
[NO] SYMBOLS 
/ [NO] STANDARD 
/TEST[:n] 
/ [NO] TRACEBACK 
/WIDTH:n 


SUMMARY OF TECHNICAL CHANGES 


EDIT EDT is now the default editor. 


FORTRAN FORTRAN IV-PLUS has been superseded by FORTRAN-77, 
although both compilers are supported by DCL 
(as well as FORTRAN IV). 


Qualifier added for FORTRAN-77: 
/(NO]STANDARD: arg 
ALL 
NONE 


SOURCE 
SYNTAX 


LINK/C81 New syntax and qualifiers for command to link 
COBOL-81 object files: 
LINK/C81 [/qualifier[s]] filespec[,s] 
LINK/COBOL [/qualifier[{s]] filespec[,s] 
/ [NO] FMS 


/OTS: [NO] RESIDENT 
/ [NO] RMS: [NO] RESIDENT 


SET DEVICE /CHECKPOINT FILE and /WIDTH now accept 
decimal numbers by default. 


SET PROTECTION Another format allowed: 


SET PROTECTION: code[/qualifier[s]] filespec[,s] 


SET TERMINAL /HFILL and /VFILL are not synonyms 
SHOW TERMINAL for /CRFILL and /LFFILL, respectively. 


Abbreviation 
DCL, 1-7 to 1-8, 9-1 
ABORT command, 7-16 to 7-21, 
9-2 
Account File Maintenance 
Program 
See ACNT 
ACNT, 3-4, 4-2, 5-8, 5-72 
ACP, 5-26, 5-28 to 5-42, 6-67 
ACT command 
MCR, 3-2 
Active task, 7-1, 7-55 to 7-57 
Active Task List 
See ATL 
ALLOCATE command, 5-4, 5-9, 
5-22 to 5-24, 9-2 
ALT MODE key, 3-12 
Ancillary Control Processor 
See ACP 
Angle bracket, 3-15 
ANSI file name 
DCL, 1-10 
ANSI magtape, 5-12 
APPEND command, 4-61 to 4-63, 
9-2 
Arrow key 
See Cursor-control key 
Assemble, 6-1 
Assembler 
MACRO-11, 6-2 to 6-11 
ASSIGN command, 4-77 to 4-78, 
5-7 to 5-8, 5-13 to 5-15, 
5-72 to 5-73, 9-3 
ASSIGN/LOGIN command, 5-8 
ASSIGN/QUEUE command, 9-3 
ASSIGN/REDIRECT command, 5-16 
to 5-18, 9-3 
ASSIGN/TASK command, 5-7, 5-18 
to 5-19, 9-4 
Asterisk (*), 3-16, 4-6 to 4-8 
At sign (@), 3-16 
AT., 1-17 
ATL, 7-46 to 7-50, 7-55 to 7-57 
Attached terminal, 3-2 


BACK SPACE key, 3-13 
Backup and Restore Utility 
See BRU utility 
BACKUP command, 5-11, 5-60 to 
5-71, 9-4 to 9-5 
Bad Block Locator Utility 
See BAD utility 
BAD utility, 5-10 to 5-12, 5-64 
to 5-65 
BADBLK.SYS file, 5-11, 5-65 


Base number 
in DCL, 1-8 
BASIC command, 6-2, 6-11 to 
6-13, 9-5 
BASIC-11/IAS-RSX, 6-11 to 6-13, 
9-5 
BASIC-PLUS-2/IAS-RSX, 6-11 to 
6-13, 9-5 
Batch processing, 9-46 
Beep, 3-22 
Bell, 3-22 
BITMAP.SYS file, 5-11, 5-65 
Blocked task, 7-23 to 7-26 
BROADCAST command, 3-29 to 3-31, 
9-6 
BRU utility, 5-12, 5-60 to 5-71 
See also BACKUP command 
Buzz, 3-22 


CANCEL command, 7-22 to 7-23, 
9-6 
CAPS LOCK key, 3-14 
Checkpoint file, 5-11, 5-65, 
5-74, 6-68 
Checkpointing, 5-11, 6-68 
Circumflex (), 3-15, 3-18 
CL: 
pseudo device, 5-6 


CLI, 1-l 
Clock queue, 7-12 to 7-15, 7-23, 
7-60, 9-37 


CMP utility, 4-69 to 4-75, 9-13 
See also DIFFERENCES command 
CO: 
pseudo device, 5-6 
COBOL command, 6-2, 6-21 to 
6-32, 9-6 to 9-7 
Colon (:), 3-16 
DCL, 1-9 
Command Line Interpreter 
See CLI 
Comments 
DCL, 1-11 
Commercial-at sign (@), 3-16 
Common 
resident, 7-61, 9-37 
Shareable, 6-73 
Compile, 6-1 
Compiler 
BASIC-PLUS-2, 6-2, 6-12 to 
6-13 
COBOL-81, 6-2, 6-21 to 6-27, 
5-6 
COBOL/C1l1l, 6-2, 6-27 to 6-32, 
9-7 


Index-l 


INDEX 


Compiler (Cont.) 
CORAL 66, 6-2, 6-32 to 6-39, 
9-9 
F4P, 6-2, 6-13 to 6-20, 9-16 
F77, 6-2, 6-13 to 6-20, 9-16 
FOR, 6-2, 6-13 to 6-20, 9-16 


9-16 
FORTRAN IV~-PLUS, 6-2, 6-13 to 
6-203 9-16 


FORTRAN-77, 6-13 to 6-20 
PDP-11 COBOL, 6-2, 6-27 to 
6-32, 9-7 
Continuation line 
See Line continuation 
CONTINUE command, 7-21 to 7-22, 
9-8 
Control key 
See CTRL key 
CONVERT command, 4-43 to 4-49, 
9-8 
COPY command, 4-37 to 4-41, 9-8 
COPY key, 3-14 
CORAL 66 command, 9-9 
CORAL command, 6-32 to 6-39 


G17 | on “a 4 
oes 


stessVewnver eee e wa v ~~ VU 7 
5-74 

CREATE command, 4-10 to 4-1l, 
9-10 


CREATE/DIRECTORY command, 4-11 
to 4-13, 9-10 

CTRL key, 3-18 

CTRL/C, 3-2, 3-12, 3-18 

CTRL/G, 3-22 

CTRL/I, 3-22 

CTRL/K, 3-22 

CTRL/L, 3-22 

CTRL/M, 3-22 

CTRL/O, 3-18, 3-20 

CTRL/Q, 3-14, 3-19 

CTRL/R, 3-21 

CTRL/S, 3-14, 3-19 

CTRL/U, 3-20 to 3-21 

CTRL/X, 3-21 

CTRL/Z, 3-12, 3-18, 3-20 

Cursor-control key, 3-17 


Date 
system, 2-1, 8-1 to 8-2, 9-31, 
9-37 
Date format 
DCL, 1-8 
DCL, 1-1 to 1-2, B-l 
ANSI file name, 1-10 
colon (:), 1-9 
command line, 1-2 
comments, 1-11 
dates, 1-8 
DECnet, 1-10 
equal sign (=), 1-9 
errors, 1-13 
line continuation, 1-1ll, 3-12 
number 


DCL 
number (Cont.) 
decimal, 1-8 
octal, 1-8 
parameter, 1-8 
qualifier, 1-3 to 1-5 
RSX-11M/M-PLUS, 1-19 
short forms, 1-7 to 1-8, 9-1 
underscore (_), 1-9 
VAX/VMS, 1-19 
DCL command, 1-7 
DEALLOCATE command, 5-24 to 


5-25, 9-10 
DEASSIGN command, 5-19 to 5-21, 
9-11 


DEASSIGN/QUEUE command, 9-11 
DEBUG command, 6-90 to 6-91, 
9-11 
DEC Standard Editor 
See EDT editor 
DECnet 
DCL, 1-10 
DECscope, 3-1 
DECtape, 5-4 
DECwriter II, 3-1 
Default device, 2-4, 4-2 to 4-3, 


4-77 to 4-79, 5-72 to 5-73, 


9-31 

Default UFD, 4-3, 4-77 to 4-79, 
5-72, 9-31 

DELETE command, 4-31 to 4-34, 
9~12 


DELETE key, 3-13 
DELETE/ENTRY command, 9-12 
DELETE/JOB command, 9-12 
DELETE/PROCESSOR command, 9-13 
DELETE/QUEUE command, 9-13 
Device, 5-l, 5-4 
default, 2-4, 4-2 to 4-3, 
4-77 to 4-79, 5-72 to 
5-73, 9-31 
peripheral, 5-1 
physical, 5-1 to 5-3, 5-5, 
5-8 
private, 5-9, 5-13, 5-22 to 
5-25 
pseudo, 5-1 to 5-8 
public, 5-9, 5-13, 5-75 
random access, 5-3 
record-oriented, 5-3 
redirection, 5-16 to 5-18 
shareable, 5-9, 5-13 
shared, 5-13 
unit record, 5-3 
unowned, 5-9, 5-13 
Device attributes, 5-77 to 5-80 
Device independence, 5-8 
Device name, 5-1] 
DIFFERENCES command, 4-69 to 
4-75, 9-13 
DIGITAL Command Language 
See DCL 
Q0O0O0000.DIR file, 5-l1l, 5-65 


Index~2 


INDEX 


DIRECTORY command, 4-22 to 4-31, 
9-14 
Disk 
preparation, 5-10 to 5-il 
scratch, 5-10 to 5-11 
Disk Save and Compress Utility 
See DSC utility 
Disk Volume Formatter Utility 
See FMT utility 
DISMOUNT command, 5-9, 5-11 to 
5-12, 5-38, 5-42 to 5-46, 
9-14 
DMP utility, 5-12 
Dormant task, 7-1 
DSC utility, 5-12 


Echo, 3-11 
EDI editor, 4-20 to 4-22, 9-16 
EDIT command, 4-14, 4-21 to 
4-22 
EDIT/EDT command, 4-14 to 4-16, 
JTL 
EDIT/SLP command, 4-17 to 4-19 
Editor 
EDI, 4-20 to 4-22, 9-15 
EDT, 4-14 to 4-16 
K52, 4-20 to 4-22, 9-16 
KED, 4-20 to 4-22, 9-16 
SLP, 4-17 to 4-19, 9-15 
SOS, 4-20 to 4-22, 9-16 
TECO, 4-20 to 4-22, 9-16 
EDT editor 
DEC Standard Editor, 4-14 to 
4-16, 9-15 
ENTER key, 3-12, 3-17 
Equal sign (=), 3-16 
DCL, 1-9 
Error 
DCL, 1-13 
Error message, A-1l 
ESC key, 3-12 
ESCAPE key, 3-12 
ESCAPE sequence from terminal, 
3-17 
Event flags 
group global, 6-91 to 6-92, 
9-32, 9-38 
EXELIB.OLB file, 6-40 
EXEMAC.MLB file, 6-41 
Extension 
file 
See File type 


Fast Task Builder, 6-70 to 6-71 
File, 4-1 
checkpoint, 5-ll, 5-65, 5-74, 
6-68 
locked, 4-75 to 4-76, 9-47 
protection, 4-9 
File Compare Utility 
See CMP utility 
File Dump Utility 


See DMP utility 


File name, 4-3 
File protection, 2-6, 4-9, 4-79 
to 4-82, 5-28, 5-38, 5-51, 
5-58, 9-33 
File Set Identifier 
See Fileset-ID 
File specification, 4-2 to 4-3 
File Structure Verification 
Utility 
See VFY utility 
File Transfer Utility 
See FLX utility 
File type, 4-3 to 4-5 
File version number, 4-3 
Files-ll, 5-4 
Fileset-ID, 5-12, 5-28, 5-38 to 
5-40 
Filespec, 4-2 to 4-3 
FIX command, 7-35 to 7-37, 9-16 
Flag 
status 
task, 7-48 
Floating qualifier, 1-3 to 1-5 
FLX utility, 5-12 
FMT utility, 5-10, 5-12 
FOREIGN qualifier 
MOUNT command, 5-9 to 5-10, 
5-12 to 5-13, 5-26, 5-29 
Foreign volume, 5-9 to 5-10, 
5-12 to 5-13, 5-26, 5-29 
FORTRAN command, 6-2, 6-13 to 
6-20, 9-16 
FORTRAN IV, 6-13 to 6-20, 9-16 
FORTRAN IV-PLUS, 6-13 to 6-20, 
9-16 
FORTRAN-77, 6-13 to 6-20, 9-16 


Global event flags 
group, 6-91 to 6-92, 9-32, 
9-38 
Group global event flags, 6-91 
to 6-92, 9-32, 9~38 


HELP command, 1-5 to 1-6, 3-22 
to 3-28, 9-17 
format, 3-28 
writing, 3-28 
HELP file 
format, 3-26 to 3~-27 
writing, 3-26 to 3-27 
HOLD qualifier 
LOGOUT command, 3-7 
HOLD/ENTRY command, 9-17 
HOLD/JOB command, 9-18 
HOLD SCREEN qualifier 
SET TERMINAL command, 3-14, 
3-19 
Home block 
volume, 5-ll, 5-47 to 5-59, 
9-18, 9-20 
HOME utility, 5-57 to 5-59, 
9-20 
Hyphen (-), 3-16 
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INDEXF.SYS file, 5-11, 5-65 to 
5-66 

Indirect command file operator 
(@) v 3-16 

Indirect command file processor, 
1-17 

INITIALIZE command, 5-4, 5-10, 
5-12, 5-47 to 5-56, 9-18 

INITIALIZE/PROCESSOR command, 
9-19 

INITIALIZE/QUEUE command, 9-20 

INITIALIZE/UPDATE command, 5-1ll, 
5-57 to 5-59, 9-20 

INSTALL command, 7-l, 7-4 to 
7-8, 7-12 to 7-15, 7-26 to 
7-34, 7-60, 9-20, 9-37 

Installed task, 7-57 to 7-58 

Interpreter 

BASIC-1ll, 6-2, 6-11 to 6-13 


Key 
ALT MODE, 3-12 
BACK SPACE, 3-13 
CAPS LOCK, 3-14 
COPY, 3-14 
CTRL; 3-18 
cursor-control, 3-17 
DELETE, 3-13 
ENTER, 3-12, 3-17 
ESC, 3-12 
ESCAPE, 3-12 
LINE FEED, 3-13 


RO CCoATT 2-1 
id he bY a a vw + 


REPEAT, 3-14 

RETURN, 3-2, 3-12, 3-17, 3-22 

SCROLL, 3-14 

SEL, 3-12 

SHIFT, 3-14 

TAB, 3-22 
Keyboard 

terminal, 3-1, 3-11 
Keypad 

terminal, 3-1, 3-17 
Keypad Editor 

See also Editor, K52 and 

Editor, KED 


LA36, 3-1, 3-14 
Label 
volume, 5-28 
Labeled magtape volume, 5-4, 
5-35 to 5-36 
Language 
source, 6-2 
Support, 6-2 
LB: 
pseudo device, 5-6 
LBR, 6-39 to 6-61 
See also LIBRARY command 
Librarian Utility 
See LBR 
Library 
macro, 6-41 


Library (Cont.) 
object module, 6-41 
shareable, 6-73 
universal, 6-41 
LIBRARY command, 6-39 to 6-61, 
9-21 
Library directory, 6-41, 7-7 to 
-7-9, 7-27, 8-4 to 8-5, 8-7, 
9-32, 9-38 
LIBRARY/COMPRESS command, 6-42 
to 6-43, 9-21 
LIBRARY/CREATE command, 6-43 to 
6-46, 9-21 
LIBRARY/DELETE command, 6-46 to 
6-47, 9-22 
LIBRARY/EXTRACT command, 6-47 
to 6-48, 9-22 
LIBRARY/INSERT command, 6-48 to 


6-50, 9-22 

LIBRARY/LIST command, 6-50 to 
6-53, 9-23 

LIBRARY/REMOVE command, 6-54, 
9-23 


LIBRARY/REPLACE command, 6-54 
to 6-56, 9-23 
Line continvation 
DCL, 1-11, 3-12 
LINE FEED key, 3-13 
Line Text Editor 
See EDI editor 
LINK command, 6-1, 6-62 to 6-89, 
7-4, 9-23 to 9-25 


Trai /MOF wee ee =a rant e- ££ AA 
LANNs COL GCUMUUAIMU, OTFOTF LU OTOF, 


9-25 
LINK/COBOL command, 6-87 to 
6-89, 9-25 


Locked file, 4-75 to 4-76, 9-47 

Logging in, 3-2, 4-2 

Logging out, 3-2 

Logical name, 5-5, 5-8, 5-13 to 
5-15 

Logical Unit Number 

See LUN 

Logical unit table, 5-8, 5-18 
to 5-19 

LOGIN command, 3-3 to 3-6, 3-9 
to 3-10, 9-25 

LOGIN.CMD file, 3-4 

LOGIN.TXT file, 3-4 

LOGOUT command, 3-7 to 3-8, 
5-13, 5-45, 9-25 

LUN, 5-5, 5-7, 5-18 to 5-19, 
7-57 to 7-58 


MACRO command, 6-2 to 6-ll, 
9-26 
Macro library, 6-41 
MACRO-11 Assembler, 6-2 to 6-l1l, 
9-26, B-2 
Magnetic tape 
See Magtape 
Magnetic Tape ACP 
See MTAACP 
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Magtape, 1-10, 5-4, 5-12, 5-27 
ANSI, 5-4, 5-34 to 5-36 
mounting, 5-38 to 5-40 

Magtape ACP 
See MTAACP 

Magtape volume 
ANSI, 5-4, 5-34 to 5-36 
labeled, 1-10, 5-4, 5-12, 

5-35 to 5-36 
unlabeled, 5-4, 5-35 to 5-36 

Master File Directory 
See MFD 

MCR, 1-1 to 1-2, B-i 

MCR command, 1-7, 9-25 

MERGE 
See CONVERT command 

Message 
error, A-l 

MFD, 4-1, 5-11, 5-65 

MK: 
pseudo device, 5-6 

Monitor Console Routine 
See MCR 

MOUNT command, 5-4, 5-9, 5-12 

to 5-13, 5-26 to 5-42, 9-27 
to 9-28 

Mounted volume, 5-9, 5-13 

MTAACP, 5-34, 5-38 to 5-40 

Multiuser task, 6-73 

MUNG qualifier 
EDIT command, 4-20 to 4-22, 

9-16 


NL: 
pseudo device, 5-6 
NO SCROLL key, 3-14 
Number 
version 
file, 4-3 
Number sign (#), 3-16 


Object module library, 6-41 
ODT, 6-90 to 6-91 
OPTIONS qualifier 
LINK command, 6-63, 6-74 to 
6-79, 6-86 


Parameter 
DCL, 1-8 
Partition, 7-38 to 7-45, 9-32 
Password, 3-3 to 3-4 
Percent sign (%), 3-16, 4-7 to 
4-8 
Peripheral device, 5-1 
Peripheral Interchange Program 
See PIP utility 
Physical device, 5-1 to 5-3, 
5-5, 5-8 
PIP, B-l 
PIP utility, 1-17 
PRINT command, 4-52 to 4-61, 
9-28 to 9-29 
Priority, 7-59 to 7-60, 9-33 


Private device, 5-9, 5-13, 5-22 
to 5-25 
Prompt, 1-3, 3-15 
Protection 
file, 2-6, 4-79 to 4-82, 5-28, 
5-38, 5-51, 5-58, 9-33 
volume, 5-31, 5-38, 5-52, 
5-58 
Pseudo device, 5-1 to 5-8 
CL:, 5-6 


5772-00 5=735° 97=31 


WK:, 5-6 
Public device, 5-9, 5-13, 5-75 
PURGE command, 4-34 to 4-37, 
9-29 


QMG, 1-16, 4-52, 9-44, 9-46, 
B-l 
Qualifier 
DCL, 1-3 to 1-5 
Floating, 1-3 to 1-5 
Queue 
clock, 7-12 to 7-15, 7-23, 
7-60, 9-37 
Queue Manager 
See QMG 


Radix-50, A-1l 
RD: 
pseudo device, 5-6 
Ready-to-run task, 7-1 
Record Management Services-1l 
See RMS-11l 
Redirection, 5-16 to 5-18 
RELEASE/ENTRY command, 9-29 
RELEASE/JOB command, 9-29 
REMOVE command, 7-34 to 7-35, 
9-29 
RENAME command, 4-41 to 4-43, 
9~30 
REPEAT key, 3-14 
REQUEST command, 3-32, 9-30 
Resident common, 7-61, 9-37 
Resource Accounting, 3-2, 3-9 
to 3-11, 9-36 
Resource Monitoring Display 
See RMD 
RETURN key, 3-2, 3-12, 3-17, 
3-22 
Right-angle bracket, 3-15 
RMD, 7-53, 7-55 to 7-57, 8-9 to 
8-13, 9-38 
RMS-11, 4-22, 4-43 to 4-49, B-1l 
RMSCNV, 4-43 to 4-49, B-l 
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RMSMAC.MLB, 6-41 

RSX-11M/M-PLUS DCL, 1-19 

RSXMAC.SML file, 6-41 

RUN command, 7-1, 7-4 to 7-16, 
7-26, 7-60, 9-30, 9-37 


Scheduling 
task, 7-12 to 7-15, 7-60, 
9-30, 9-37 


Scratch disk, 5-10 to 5-11 

SCROLL key, 3-14 

SEL key, 3-12 

SET DAYTIME command, 2-1, 8-l, 
9-31 

SET DEBUG command, 1-2, 1-12 to 
1-13, 2-7 

SET DEFAULT command, 2-4, 4-77 
to 4-78, 5-72 to 5-73, 9-31 

SET DEVICE command, 5-9, 5-74 
to 5-76, 9-31 

SET GROUPFLAGS command, 6-91 to 
6-92, 9-32 

SET LIBRARY/DIRECTORY command, 
2-7, 8-4, 9-32 

SET NODEBUG command, 1-2, 1-12 
to 1-13, 2-7 

SET NOPARTITION command, 7-38 
to 7-43, 9-32 

SET PARTITION command, 7-38 to 
7-43, 9-32 

SET PRIORITY command, 7-59 to 
7-60, 9-33 

SET PROTECTION command, 2-6. 
4-79 to 4-82, 9-33 

SET QUEUE/ENTRY command, 9-33 

SET QUEUE/JOB command, 9-34 

SET SYSTEM command, 8-3 to 8-4, 
9-34 

SET SYSTEM/DIRECTORY command, 
2-6 

SET TERMINAL command, 2-2 to 
2-3, 3-33 to 3-42, 9-35 

SET TERMINAL/HOLD SCREEN 
command, 3-14, 3-19 

SET TIME command, 2-1, 8-l, 
9-31 

Shareable common, 6-73 

Shareable device, 5-9, 5-13 

Shareable library, 6-73 

Shareable task, 6-73 

Shareable volume, 5-31, 5-38 

Shared device, 5-13 

SHIFT key, 3-14 

Short forms 

DCL, 1-7 to 1-8, 9-1 

SHOW ACCOUNTING command, 3-9 

SHOW ACCOUNTING/INFORMATION 
command, 9-36 

SHOW ASSIGNMENTS command, 2-4, 
5-72 to 5-73, 9-36 

SHOW CLOCK QUEUE command, 7-60, 
9-37 


SHOW COMMON comman 


nd ors 


, 


SHOW DAYTIME command, 2-1 to 
2-2, 8-2, 9-37 

SHOW DEFAULT command, 2-4, 3-2, 
4-79, 9-37 

SHOW DEVICES command, 2-3, 5-4, 
5-77 to 5-80, 9-37 

SHOW GROUPFLAGS command, 6-92, 
9-38 

SHOW LIBRARY command, 8-7 

SHOW LIBRARY/DIRECTORY command, 
2-7, 9-38 

SHOW MEMORY command, 2-2, 8-9 
to 8-13, 9-38 

SHOW PARTITIONS command, 7-43 
to 7-45, 9-38 

SHOW PROCESSOR command, 2-4, 
9-39 

SHOW QUEUE command, 2-3 to 2-4, 
9-39 

SHOW QUEUE/FULL command, 2-4 

SHOW SYSTEM command, 8-5 to 8-7, 
9-40 

SHOW SYSTEM/DIRECTORY command, 
2-7 

SHOW TASK command, 9-40 

SHOW TASK/LOGICAL UNITS command, 
7-57 to 7-58 ~~ 

SHOW TASK: taskname/DYNAMIC 
command, 7-53 to 7-54, 9-40 

SHOW TASKS, 7-45 

SHOW TASKS command, 2-5 

SHOW TASKS/ACTIVE command, 2-5, 
3-2, 7-46 to 7-50, 9-40 

SHOW TASKS/ACTIVE/DYNAMIC 
command, 7-55 to 7-57, 9-40 

SHOW TASKS/INSTALLED command, 
2-5, 7-51 to 7-53, 9-40 

SHOW TERMINAL command, 2-2 to 
2-3, 3-43 to 3-54, 9-41 to 


9-42 

SHOW TIME command, 2-1 to 2-2, 
S= 25) 9-37 

SHOW USERS command, 2-5, 8-7 to 
8-8, 9-42 


Slash (/), 3-17 
Slave terminal, 3-41 
SLIPR 
See SLP utility 
Slow Task Builder, 6-81 
SLP utility, 4-17 to 4-19, 9-15 
Son of Stopgap 
See SOS editor 
SORT command, 4-63 to 4-69, 
9-42 
SORT-11, 4-63 to 4-69, 9-42 
SOS editor, 4-20 to 4-22, 9-16 
Source language, 6-2 
Source Language Input Program 
See SLP utility 
SP: 
pseudo device, 5-6 
SQUEEZE qualifier 


YT As a Os 
LISRARY command, 6-41 
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START command, 7-25, 9-43 
START/PROCESSOR command, 9-43 
START/QUEUE command, 9-44 
START/QUEUE/MANAGER command, 
9-44 
START/UNBLOCK command, 7-25 to 
7-26, 9-44 
Status flag 
task, 7-48 
STD, 7-1 to 7-2, 7-26 to 7-34, 
7-51 to 7-53, 9-29 
TOP/ABORT command, 9-44 
STOP/BLOCK command, 7-23 to 
7-24, 9-45 
STOP/PROCESSOR command, 9-45 
STOP/QUEUE command, 9-45 
STOP/QUEUE/MANAGER command, 
9-46 
Stopped task, 7-25 
SUBMIT command, 9-46 
Subpartition, 7-38, 7-40 to 
7-45, 9-32 
SY: 
pseudo device, 4-2, 4-77 to 
4-79, 5-6, 5-72 to 5-73, 
9-31 
SYSLIB.OLB file, 6-40, 6-81 
SYSLOGIN.CMD file, 3-4 
System date, 2-1, 8-1 to 8-2, 
9-31, 9-37 
System directory, 6-41, 7-7 to 
7-9, 7-27, 8-5 
System library, 8-4 
System Task Directory 


See STD 
System time, 2-1, 8-1 to 8-2, 
9-31, 9-37 
Tab 


Vertical, 3-22 
TAB key, 3-22 
Tape set 
mounting, 5-38 to 5-40 
Task, 7-1 
active, 7-1, 7-55 to 7-57 
blocked, 7-23 to 7-26, 9-44 
dormant, 7-1 
installed, 7-57 to 7-58 
multiuser, 6-73 
name, 7-2 to 7-3, 7-5 
RSX-11M, 7-4 
RSX-11M-PLUS, 7-5 
ready-to-run, 7-1 
scheduling, 7-12 to 7-15, 
7-60, 9-30, 9-37 
shareable, 6-73 
state, 7-1 
stopped, 7-25, 9-43 
Task Builder, 9-23 to 9-24 
See TKB 
Task status flag, 7-48 


INDEX 


Task Termination Notification 
program 
See TKTN 
Task-build, 6-1, 6-62 to 6-86, 
6-88 to 6-89 
Technical changes 
RSX-11M-PLUS, C-1l 
TECO editor, 4-21 to 4-22, 9-16 
Terminal 
attached, 3-2 
attributes, 2-2 to 2-3, 3-2, 
3-33 to 3-54, 9-35 
characteristics, 2-2 to 2-3, 
3-2, 3-33 to 3-54, 9-35 
model, 2-2 to 2-3, 3-2, 3-33 
to 3-54, 9-35 
number, 3-l 
Slave, 3-41 
slaved, 3-2 
Terminal keyboard, 3-1, 3-11 
Terminal keypad, 3-1, 3-17 
Text Editor and Corrector 
See TECO editor 
TI: 
Pseudo device, 5-6 
Time 


system, 2-1, 8-1 to 8-2, 9-31, 


9-37 
TKB, 6-1, 6-62 to 6-89, B-2 
options, 6-76 to 6-79, 6-86 
TKTN, 7-19 to 7-21 
TYPE command, 4-50 to 4-52, 
9-46 


UFD, 4-1, 5-ll, 5-65 
creating, 4-1ll 
default, 4-3, 4-77 to 4-79, 
5-72, 9-31 
UIC, 3-3 to 3-4, 4-2 
Underscore (_), 1-9, 3-16 
UNFIX command, 7-37 to 7-38, 
9~-47 
Universal library, 6-41 
Unlabeled magtape volume, 5-4, 
5-35 to 5-36 
UNLOCK command, 4-75 to 4-76, 
9-47 
Unowned device, 5-9, 5-13 
User File Directory 
See UFD 
User Identification Code 
See UIC 
User name, 3-3 to 3-4 
Utilities, 1-17 to 1-19, B-l 


VAX/VMS DCL, 1-19 

Version number 
file,-~4-3 

Vertical tab, 3-22 

VEY utility, 5-12 

VMLIB.OLB file, 6-40 
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Volume, 4-1, 5-3 to 5-4, 5-26 Volume Identifier 
to 5-27, 5-29 to 5-42 See Volume-ID 
disk, 5-3 to 5-4, 5-38 Volume label, 5-28 
foreign, 5-9 to 5-10, 5-12 to Volume protection, 5-38, 5-52, 
5-13, 5-26, 5-29 5-58 
Imag tape Volume-ID, 5-38 to 5-40 
labeled, 5-4, 5-35 to 5-36 VT100, 3-1, 3-14 
unlabeled, 5-4, 5-35 to VT52, 3-1, 3-14, 3-18 
5-36 VT: 
mounted, 5-9, 5-13 pseudo device, 5-6 
protection, 4-9 
Shareable, 5-31, 5-38 Wildcard, 3-16, 4-6 to 4-8 
Volume Home Block, 5-11, 5-47 WK: 
to 5-59, 9-18, 9-20 pseudo device, 5-6 
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Command Language Manual 
AA-L672B-TC 
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NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company’s discretion. If you require a written reply and are eligible to receive one under Software 
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